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

# List broker credentials for an organization

> Lists credential metadata across the caller's organization without returning secret values. The organization is taken from the authenticated principal and cannot be named in the request. Pass `account_id` to narrow the listing to one trading account; an account the caller does not own matches nothing and returns an empty page. Service tokens require `credential:read` and must pass `account_id`, because a service has no organization of its own to scope the read to. Each page contains up to 100 credentials.



## OpenAPI

````yaml /api-reference/accounts.openapi.json get /v1/accounts/credentials
openapi: 3.1.0
info:
  title: accounts
  description: ''
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://api.anthid.com
    description: Production
security: []
tags:
  - name: Accounts
    description: Create, inspect, update, and disable trading accounts
  - name: Broker Credentials
    description: Inspect and manage credentials linked to trading accounts
paths:
  /v1/accounts/credentials:
    get:
      tags:
        - Broker Credentials
      summary: List broker credentials for an organization
      description: >-
        Lists credential metadata across the caller's organization without
        returning secret values. The organization is taken from the
        authenticated principal and cannot be named in the request. Pass
        `account_id` to narrow the listing to one trading account; an account
        the caller does not own matches nothing and returns an empty page.
        Service tokens require `credential:read` and must pass `account_id`,
        because a service has no organization of its own to scope the read to.
        Each page contains up to 100 credentials.
      operationId: listOrganizationCredentials
      parameters:
        - name: account_id
          in: query
          description: >-
            Narrows the listing to one trading account. Required for service
            tokens.
          required: false
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        - name: cursor
          in: query
          description: Cursor from the previous page
          required: false
          schema:
            type: string
          example: >-
            2026-08-05T16:20:00+00:00|550e8400-e29b-41d4-a716-446655440111|550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Credentials retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBrokerCredentialResponse'
              example:
                data:
                  - created_at: '2026-08-05T16:20:00Z'
                    enabled: true
                    id: 550e8400-e29b-41d4-a716-446655440111
                    trading_account_id: 550e8400-e29b-41d4-a716-446655440000
                    updated_at: '2026-08-05T16:20:00Z'
                    vault_object_id: vault_object_01J4Q4Z7Q9J6M8T2H1N5K3P0RX
                    vault_object_name: >-
                      credential-550e8400-e29b-41d4-a716-446655440222-lightspeed-LS-123456-paper
                next_cursor: null
        '400':
          description: >-
            Pagination cursor is invalid, does not match the `account_id`
            filter, or a service token omitted `account_id`
          content:
            text/plain:
              schema:
                type: string
        '401':
          description: Missing or invalid authentication credentials
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: Caller cannot read credential metadata
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: Caller exceeded the request rate limit
          content:
            text/plain:
              schema:
                type: string
        '500':
          description: Unexpected server error while listing credentials
          content:
            text/plain:
              schema:
                type: string
      security:
        - bearerAuth: []
        - clientCredentials: []
        - apiKeyAuth: []
components:
  schemas:
    ListBrokerCredentialResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/BrokerCredential'
        next_cursor:
          type:
            - string
            - 'null'
    BrokerCredential:
      type: object
      required:
        - id
        - trading_account_id
        - vault_object_name
        - vault_object_id
        - enabled
        - created_at
        - updated_at
      properties:
        created_at:
          type: string
          format: date-time
        enabled:
          type: boolean
        id:
          type: string
          format: uuid
        trading_account_id:
          type: string
          format: uuid
        updated_at:
          type: string
          format: date-time
        vault_object_id:
          type: string
        vault_object_name:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    clientCredentials:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Machine bearer token minted via the client_credentials grant.
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````