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

# Get phoneidentities



## OpenAPI

````yaml /openapi.json get /phone/identities
openapi: 3.1.1
info:
  title: Anima API
  version: 0.1.0
  description: >-
    The Anima API provides programmatic access to unified infrastructure for AI
    agents: create and manage agents; send and receive email; place phone calls
    and send/receive SMS and voice; store and retrieve vault credentials; manage
    agent identity; and configure webhooks for real-time events. Authenticate
    using a Bearer token or an API key passed via the X-API-Key header.
  contact:
    name: Anima Labs
    url: https://useanima.sh
    email: support@useanima.sh
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://api.useanima.sh/v1
    description: Production
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /phone/identities:
    get:
      operationId: phone.listIdentities
      parameters:
        - name: cursor
          in: query
          schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
            description: Opaque cursor from a previous response to fetch the next page
          allowEmptyValue: true
          allowReserved: true
        - name: limit
          in: query
          schema:
            default: 20
            type: integer
            minimum: 1
            maximum: 100
            description: Maximum number of items to return per page (1–100, default 20)
          allowEmptyValue: true
          allowReserved: true
        - name: query
          in: query
          schema:
            type: string
            minLength: 1
            maxLength: 120
            description: >-
              Free-text search. Digits match the number itself, ignoring
              punctuation and spacing; the raw term also matches the owning
              agent's name or slug.
          allowEmptyValue: true
          allowReserved: true
        - name: agentId
          in: query
          schema:
            anyOf:
              - type: string
                pattern: ^[0-9a-z]+$
              - type: string
                pattern: ^[cC][^\s-]{8,}$
            description: >-
              Restrict to one agent's numbers. Omit to list every number in the
              organization. An agent key is confined to its own numbers whether
              or not this is set.
          allowEmptyValue: true
          allowReserved: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          pattern: ^[cC][^\s-]{8,}$
                          description: Unique identifier of the phone identity
                        phoneNumber:
                          type: string
                          description: Phone number in E.164 format
                        providerId:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Opaque carrier-side identifier for this phone number
                        capabilities:
                          type: object
                          properties:
                            sms:
                              default: false
                              type: boolean
                              description: Whether the number supports SMS messaging
                            mms:
                              default: false
                              type: boolean
                              description: Whether the number supports MMS messaging
                            voice:
                              default: false
                              type: boolean
                              description: Whether the number supports voice calls
                          description: >-
                            Communication capabilities supported by this phone
                            number
                        tenDlcStatus:
                          enum:
                            - PENDING
                            - REGISTERED
                            - REJECTED
                            - NOT_REQUIRED
                            - UNREGISTERED
                          type: string
                          description: 10DLC campaign registration status
                        isPrimary:
                          type: boolean
                          description: Whether this is the agent's primary phone identity
                        voiceId:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: >-
                            The voice this number answers with, from the voice
                            catalog. Null means it uses the agent's voice, and
                            then the system default. Set it per number so one
                            agent's support line and sales line can sound
                            different.
                        createdAt:
                          type: string
                          format: date-time
                          description: Timestamp when the phone identity was created
                        agentId:
                          type: string
                          description: Agent that owns the number
                        agentName:
                          type: string
                          description: Name of the agent that owns the number
                        agentSlug:
                          type: string
                          description: Slug of the agent that owns the number
                      required:
                        - id
                        - phoneNumber
                        - providerId
                        - capabilities
                        - tenDlcStatus
                        - isPrimary
                        - voiceId
                        - createdAt
                        - agentId
                        - agentName
                        - agentSlug
                      description: Phone identity associated with an agent
                    description: >-
                      Phone identities matching the query, with their owning
                      agent
                  pagination:
                    type: object
                    properties:
                      nextCursor:
                        anyOf:
                          - type: string
                            pattern: ^[cC][^\s-]{8,}$
                          - type: 'null'
                        description: >-
                          Cursor to pass as the `cursor` parameter to retrieve
                          the next page, or null if no more results
                      hasMore:
                        type: boolean
                        description: Whether additional pages of results are available
                    required:
                      - nextCursor
                      - hasMore
                    description: Cursor-based pagination metadata
                required:
                  - items
                  - pagination
                description: Paginated list of phone numbers across an organization
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT Bearer token obtained from authentication. Pass as: Authorization:
        Bearer <token>
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'API key for programmatic access. Pass as: X-API-Key: <your-key>'

````