---
title: "List Invitations"
method: GET
path: "/api/v1/invitations"
tags: ["Invitations"]
---

# List Invitations

`GET /api/v1/invitations`

List invitations for the current business with filtering and pagination.

Query parameters:
- **status__eq**: Filter by status (pending, accepted, rejected, expired, revoked)
- **business_id__eq**: Filter by business ID (alias for inviter_business_id__eq)
- **inviter_business_id__eq**: Filter by inviter business ID
- **invitee_user_id__eq**: Filter by invitee user ID
- **created_at__gte**: Filter by created date (greater than or equal)
- **created_at__lte**: Filter by created date (less than or equal)
- **expires_at__gte**: Filter by expiry date (greater than or equal)
- **expires_at__lte**: Filter by expiry date (less than or equal)
- **sort**: Sort fields (e.g., "-created_at" for descending, "status" for ascending)
- **page**: Page number (default: 1)
- **limit**: Items per page (default: 10, max: 100)

Example: `/api/v1/invitations?status__eq=pending&business_id__eq=123&sort=-created_at&page=1&limit=10`

Note: By default, invitations are filtered to the current authenticated business.
You can override this by specifying business_id__eq or inviter_business_id__eq.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Successful Response

- SimplePaginatedResponse — Simplified paginated response wrapper. Returns only essential pagination metadata: items, total, has_next, has_prev.
  - `items` unknown[], required — List of items for current page
    - unknown
  - `total` integer, required — Total number of items matching filters
  - `has_next` boolean, required — Whether there is a next page
  - `has_prev` boolean, required — Whether there is a previous page

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/neosapien/apis/neocore.md) · [All operations](https://skmtc.dev/neosapien/apis/neocore/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neosapien/neocore/revisions/8b94ef58f2cf/schema)