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

# Get number (Meta details)

> Returns the number + all Meta info when it is an official-API number: a nested `meta` block (phone / profile / waba, camelCase) with quality, messaging-limit tier, verification status, business profile and WABA data, plus `health`. Served from cache by default; pass `?refresh=1` to fetch live from the Meta Graph and persist. Non-Meta numbers return `meta: null`. (The same route accepts DELETE to remove; use GET /api/v1/numbers/:id/status for a lightweight state-only poll.)



## OpenAPI

````yaml openapi.json GET /v1/numbers/{id}
openapi: 3.1.0
info:
  title: Pilot Status API
  version: 1.0.0
  license:
    name: Pilot Status Terms of Service
    url: https://pilotstatus.com.br/terms
  description: >-
    Public REST API for Pilot Status. Authenticate with the `x-api-key: ps_...`
    header (or `x-api-key-id`). Base URL: https://pilotstatus.com.br
servers:
  - url: https://pilotstatus.com.br
security:
  - apiKey: []
  - apiKeyId: []
paths:
  /v1/numbers/{id}:
    get:
      tags:
        - Numbers
      summary: Get number (Meta details)
      description: >-
        Returns the number + all Meta info when it is an official-API number: a
        nested `meta` block (phone / profile / waba, camelCase) with quality,
        messaging-limit tier, verification status, business profile and WABA
        data, plus `health`. Served from cache by default; pass `?refresh=1` to
        fetch live from the Meta Graph and persist. Non-Meta numbers return
        `meta: null`. (The same route accepts DELETE to remove; use GET
        /api/v1/numbers/:id/status for a lightweight state-only poll.)
      operationId: get_numbers_id
      parameters:
        - name: id
          in: path
          required: true
          description: WhatsApp number id.
          schema:
            type: string
          example: num_01HZX...
        - name: refresh
          in: query
          required: false
          description: >-
            Pass `1` to force a live fetch from the Meta Graph and refresh the
            cache.
          schema:
            type: string
          example: '1'
      responses:
        '200':
          description: Get Meta number
          content:
            application/json:
              example:
                id: num_01HZX...
                number: '+5511999999999'
                name: Atendimento
                provider: META
                state: OPEN
                isFullyConnected: true
                health:
                  qualityRating: GREEN
                  messagingLimitTier: TIER_2K
                  metaStatus: CONNECTED
                  sendable: true
                meta:
                  fetchedAt: '2026-06-30T08:55:00.000Z'
                  phone:
                    displayPhoneNumber: +55 11 99999-9999
                    verifiedName: Minha Empresa
                    qualityRating: GREEN
                    status: CONNECTED
                    codeVerificationStatus: VERIFIED
                    nameStatus: APPROVED
                    platformType: CLOUD_API
                    throughput:
                      level: STANDARD
                    messagingLimitTier: TIER_2K
                    businessManagerMessagingLimit: TIER_2K
                    accountMode: LIVE
                  profile:
                    about: Atendimento oficial
                    email: contato@empresa.com
                    websites:
                      - https://empresa.com
                    vertical: PROF_SERVICES
                  waba:
                    id: '1234567890'
                    name: Empresa WABA
                    currency: BRL
                    businessVerificationStatus: verified
                    accountReviewStatus: APPROVED
                    ownershipType: CLIENT
                  errors: {}
        '400':
          description: Invalid payload or parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Validation error
        '401':
          description: Missing or invalid `x-api-key` / `x-api-key-id` header
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Unauthorized
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Too many requests
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your ps_ API key
    apiKeyId:
      type: apiKey
      in: header
      name: x-api-key-id
      description: API key id (alternative to x-api-key)

````