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

# Obter número (detalhes Meta)

> Retorna o número + todas as informações da Meta quando for um número da API oficial: bloco `meta` aninhado (phone / profile / waba, camelCase) com qualidade, tier de mensagens, status de verificação, perfil de negócio e dados da WABA, além de `health`. Servido do cache por padrão; passe `?refresh=1` para buscar ao vivo no Graph da Meta e persistir. Número não-Meta retorna `meta: null`. (A mesma rota aceita DELETE para remover; use GET /api/v1/numbers/:id/status para um poll leve só de estado.)



## OpenAPI

````yaml openapi.pt.json GET /v1/numbers/{id}
openapi: 3.1.0
info:
  title: API Pilot Status
  version: 1.0.0
  license:
    name: Pilot Status Terms of Service
    url: https://pilotstatus.com.br/terms
  description: >-
    API REST pública do Pilot Status. Autentique com o header `x-api-key:
    ps_...` (ou `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: Obter número (detalhes Meta)
      description: >-
        Retorna o número + todas as informações da Meta quando for um número da
        API oficial: bloco `meta` aninhado (phone / profile / waba, camelCase)
        com qualidade, tier de mensagens, status de verificação, perfil de
        negócio e dados da WABA, além de `health`. Servido do cache por padrão;
        passe `?refresh=1` para buscar ao vivo no Graph da Meta e persistir.
        Número não-Meta retorna `meta: null`. (A mesma rota aceita DELETE para
        remover; use GET /api/v1/numbers/:id/status para um poll leve só de
        estado.)
      operationId: get_numbers_id
      parameters:
        - name: id
          in: path
          required: true
          description: Id do número WhatsApp.
          schema:
            type: string
          example: num_01HZX...
        - name: refresh
          in: query
          required: false
          description: >-
            Passe `1` para forçar uma busca ao vivo no Graph da Meta e atualizar
            o cache.
          schema:
            type: string
          example: '1'
      responses:
        '200':
          description: Obter número Meta
          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: Payload ou parâmetros inválidos
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Validation error
        '401':
          description: Header `x-api-key` / `x-api-key-id` ausente ou inválido
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Unauthorized
        '429':
          description: Limite de taxa excedido
          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: Sua chave de API ps_
    apiKeyId:
      type: apiKey
      in: header
      name: x-api-key-id
      description: Id da chave de API (alternativa ao x-api-key)

````