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

# List members

See the [Members API guide](/account/members-api#pagination) for filtering and pagination examples.


## OpenAPI

````yaml GET /api/v1/organizations/{org}/members
openapi: 3.1.0
info:
  title: cubic API
  version: 1.0.0
servers:
  - url: https://www.cubic.dev
security:
  - apiKey: []
externalDocs:
  url: https://docs.cubic.dev/account/members-api
paths:
  /api/v1/organizations/{org}/members:
    get:
      summary: List members
      operationId: listMembers
      parameters:
        - name: org
          in: path
          required: true
          description: GitHub organization login, such as acme.
          schema:
            type: string
            minLength: 1
            maxLength: 255
        - name: search
          in: query
          required: false
          description: Match part of a GitHub login.
          schema:
            type: string
            maxLength: 255
        - name: role
          in: query
          required: false
          schema:
            type: string
            enum:
              - member
              - admin
              - viewer
        - name: seat
          in: query
          required: false
          description: true for members with a seat, false for members without one.
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
        - name: cursor
          in: query
          required: false
          description: The nextCursor from the previous page.
          schema:
            type: string
            maxLength: 255
        - name: limit
          in: query
          required: false
          schema:
            default: 20
            type: integer
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: OK
          headers:
            X-RateLimit-Limit:
              description: Requests allowed per 15-minute window.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in the current window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: When the window resets, in Unix epoch seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberList'
        '400':
          description: The request is invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: The API key is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Your cubic access does not allow this.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: The organization or member was not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: The rate limit is exhausted. Retry after the Retry-After header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Temporarily unavailable. Retry shortly.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    MemberList:
      type: object
      properties:
        members:
          type: array
          items:
            type: object
            properties:
              githubUserId:
                type: string
              githubLogin:
                anyOf:
                  - type: string
                  - type: 'null'
              workEmail:
                anyOf:
                  - type: string
                  - type: 'null'
              role:
                type: string
                enum:
                  - member
                  - admin
                  - viewer
              seat:
                type: boolean
              isBot:
                type: boolean
            required:
              - githubUserId
              - githubLogin
              - workEmail
              - role
              - seat
              - isBot
            additionalProperties: false
        nextCursor:
          anyOf:
            - type: string
            - type: 'null'
      required:
        - members
        - nextCursor
      additionalProperties: false
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Stable error code. Branch on this, not on the message.
            message:
              type: string
            retriable:
              type: boolean
              description: Whether the same request can succeed if you send it again.
            correlationId:
              description: Quote this ID when you contact support.
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
                required:
                  - path
                  - message
                additionalProperties: false
          required:
            - code
            - message
            - retriable
          additionalProperties: false
      required:
        - error
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        Your personal cubic API key from Settings > Integrations > cubic API. It
        starts with cbk_.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.