> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Invites

> Lists organization invites, filtered by status



## OpenAPI

````yaml latest.yml GET /organizations/invites
openapi: 3.0.1
info:
  title: Cartesia API
  version: 0.0.1
servers:
  - url: https://api.cartesia.ai
    description: Production
security: []
paths:
  /organizations/invites:
    get:
      tags:
        - Organizations
      summary: List Invites
      description: Lists organization invites, filtered by status
      operationId: getOrganizationsInvites
      parameters:
        - name: limit
          in: query
          description: >-
            The maximum number of items to return. Defaults to 20; values above
            100 are capped at 100.
          schema:
            type: integer
            default: 20
            maximum: 100
            minimum: 1
        - name: starting_after
          in: query
          description: >-
            An opaque pagination cursor from `next_page`. Pass it back to fetch
            the next page. Cannot be combined with `ending_before`.
          schema:
            type: string
        - name: ending_before
          in: query
          description: >-
            An opaque pagination cursor from `next_page`. Pass it back to fetch
            the previous page. Cannot be combined with `starting_after`.
          schema:
            type: string
        - name: status
          in: query
          description: Filter invites by status. Defaults to `pending`.
          schema:
            type: string
            default: pending
            enum:
              - pending
              - accepted
              - revoked
              - expired
        - $ref: '#/components/parameters/CartesiaVersionHeader'
      responses:
        '200':
          description: List Invites
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    description: The requested page of results
                    type: array
                    items:
                      $ref: '#/components/schemas/OrganizationInvite'
                  has_more:
                    description: Whether more results are available after this page
                    type: boolean
                  next_page:
                    type: string
                    nullable: true
                    description: >-
                      An ID that can be passed as `starting_after` or
                      `ending_before` to get the next page of data
                required:
                  - data
                  - has_more
              example:
                data:
                  - id: orginv_123
                    email: jsmith@example.com
                    role: member
                    status: pending
                    created_at: '2023-11-07T05:31:56Z'
                    expires_at: '2023-12-07T05:31:56Z'
                has_more: false
                next_page: null
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListInvitesBadRequestError'
        '500':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnexpectedErrorResponse'
      security:
        - AdminAPIKeyAuth: []
components:
  parameters:
    CartesiaVersionHeader:
      name: Cartesia-Version
      in: header
      description: API version header.
      required: true
      schema:
        type: string
        format: date
        example: '2026-03-01'
        default: '2026-03-01'
        enum:
          - '2026-03-01'
  schemas:
    OrganizationInvite:
      description: An invite to join the organization
      type: object
      properties:
        created_at:
          description: When the invite was created
          type: string
          format: date-time
        email:
          description: Email address the invite was sent to
          type: string
        expires_at:
          type: string
          format: date-time
          nullable: true
          description: When the invite expires, if it has an expiry
        id:
          description: Unique identifier for the invite
          type: string
        role:
          description: Role the invited user will receive when they accept
          type: string
          enum:
            - admin
            - member
        status:
          description: Status of the invite
          type: string
          enum:
            - pending
            - accepted
            - revoked
            - expired
      required:
        - id
        - email
        - role
        - status
        - created_at
        - expires_at
      title: OrganizationInvite
    ListInvitesBadRequestError:
      allOf:
        - $ref: '#/components/schemas/PublicErrorResponse'
      example:
        request_id: 0834487a-17d6-40e5-80b6-4a19b140e685
        message: >-
          ✖ Invalid option: expected one of
          "pending"|"accepted"|"revoked"|"expired"
            → at status
        title: Invalid request
      title: ListInvitesBadRequestError
    UnexpectedErrorResponse:
      allOf:
        - $ref: '#/components/schemas/PublicErrorResponse'
      example:
        title: Unexpected error
        message: >-
          An unexpected error occurred, please contact support@cartesia.ai if
          the problem persists.
      title: UnexpectedErrorResponse
    PublicErrorResponse:
      type: object
      properties:
        doc_url:
          description: URL to relevant documentation for the error
          type: string
          nullable: true
        error_code:
          description: Machine-readable error code
          type: string
          nullable: true
        message:
          description: Detailed human-readable error message
          type: string
        request_id:
          description: >-
            Unique identifier for this request. Include this when contacting
            support.
          type: string
        title:
          description: Short human-readable error summary, like "File too large"
          type: string
      required:
        - request_id
        - message
        - title
      title: PublicErrorResponse
  securitySchemes:
    AdminAPIKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: Admin API Key
      description: >-
        Cartesia admin API key (`sk_car_admin_...`). Get one at
        [play.cartesia.ai/keys/admin](https://play.cartesia.ai/keys/admin).
      x-default: $CARTESIA_ADMIN_API_KEY

````