> ## 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 Users

> Lists users in the organization, ordered by when they joined (newest first)



## OpenAPI

````yaml latest.yml GET /organizations/users
openapi: 3.0.1
info:
  title: Cartesia API
  version: 0.0.1
servers:
  - url: https://api.cartesia.ai
    description: Production
security: []
paths:
  /organizations/users:
    get:
      tags:
        - Organizations
      summary: List Users
      description: >-
        Lists users in the organization, ordered by when they joined (newest
        first)
      operationId: getOrganizationsUsers
      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: q
          in: query
          description: Free-text search over user name and email
          schema:
            type: string
        - $ref: '#/components/parameters/CartesiaVersionHeader'
      responses:
        '200':
          description: List Users
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    description: The requested page of results
                    type: array
                    items:
                      $ref: '#/components/schemas/OrganizationUser'
                  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:
                  - created_at: '2023-11-07T05:31:56Z'
                    email: jsmith@example.com
                    id: user_123
                    image_url: https://example.com
                    name: James Smith
                    role: member
                has_more: false
                next_page: null
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersBadRequestError'
        '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:
    OrganizationUser:
      description: A user in the organization
      type: object
      properties:
        created_at:
          description: When the user joined the organization
          type: string
          format: date-time
        email:
          description: Primary email address of the user, if available
          type: string
          format: email
          nullable: true
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
        id:
          description: >-
            Stable identifier for the user. Safe to pass to [Get
            User](/api-reference/organizations/get-user) and [Remove
            User](/api-reference/organizations/remove-user).
          type: string
        image_url:
          description: Profile image URL for the user, if available
          type: string
          nullable: true
        name:
          description: Full name of the user, if available
          type: string
          nullable: true
        role:
          description: Role of a user in the organization
          type: string
          enum:
            - admin
            - member
      required:
        - id
        - email
        - name
        - role
        - image_url
        - created_at
      title: OrganizationUser
    ListUsersBadRequestError:
      allOf:
        - $ref: '#/components/schemas/PublicErrorResponse'
      example:
        request_id: 691becb2-3fe9-4f17-9c7a-4c565882f75a
        message: ✖ Cannot specify both ending_before and starting_after parameters
        title: Invalid request
      title: ListUsersBadRequestError
    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

````