> ## 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 preços de mensagens

> Preço por mensagem publicado da Meta / WhatsApp Business Platform para um único mercado + moeda + categoria. Dado de referência global - NÃO é a cobrança real do tenant. Chame sem parâmetros para metadados (mercados, moedas, categorias). Envie market + currency + category para o preço flat; adicione tiers=true para os volume tiers. Qualquer API key válida funciona.



## OpenAPI

````yaml openapi.pt.json GET /v1/meta/pricing
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/meta/pricing:
    get:
      tags:
        - Pricing
      summary: Preço de mensagem
      description: >-
        Preço por mensagem publicado da Meta / WhatsApp Business Platform para
        um único mercado + moeda + categoria. Dado de referência global - NÃO é
        a cobrança real do tenant. Chame sem parâmetros para metadados
        (mercados, moedas, categorias). Envie market + currency + category para
        o preço flat; adicione tiers=true para os volume tiers. Qualquer API key
        válida funciona.
      operationId: get_meta_pricing
      parameters:
        - name: market
          in: query
          required: false
          description: >-
            Código do mercado. Códigos: AR Argentina, BR Brasil, CL Chile, CO
            Colômbia, EG Egito, FR França, DE Alemanha, HK Hong Kong, HU
            Hungria, IN Índia, ID Indonésia, IL Israel, IT Itália, MY Malásia,
            MX México, NL Países Baixos, NG Nigéria, NAM América do Norte, PK
            Paquistão, PE Peru, PL Polônia, QA Catar, RO Romênia, RU Rússia, SA
            Arábia Saudita, SG Singapura, ZA África do Sul, ES Espanha, TR
            Turquia, AE Emirados Árabes Unidos, GB Reino Unido, GLO Outros, AFR
            Resto da África, APAC Resto da Ásia-Pacífico, CEEU Resto da Europa
            Central e Oriental, LATAM Resto da América Latina, MDE Resto do
            Oriente Médio, WEU Resto da Europa Ocidental.
          schema:
            type: string
            enum:
              - AR
              - BR
              - CL
              - CO
              - EG
              - FR
              - DE
              - HK
              - HU
              - IN
              - ID
              - IL
              - IT
              - MY
              - MX
              - NL
              - NG
              - NAM
              - PK
              - PE
              - PL
              - QA
              - RO
              - RU
              - SA
              - SG
              - ZA
              - ES
              - TR
              - AE
              - GB
              - GLO
              - AFR
              - APAC
              - CEEU
              - LATAM
              - MDE
              - WEU
          example: BR
        - name: currency
          in: query
          required: false
          description: Moeda ISO 4217.
          schema:
            type: string
            enum:
              - USD
              - AED
              - ARS
              - AUD
              - BRL
              - CLP
              - COP
              - EUR
              - GBP
              - IDR
              - INR
              - MXN
              - MYR
              - PEN
              - SAR
              - SGD
          example: BRL
        - name: category
          in: query
          required: false
          description: Categoria da mensagem (obrigatória junto com market + currency).
          schema:
            type: string
            enum:
              - marketing
              - utility
              - authentication
              - service
              - authentication_international
          example: authentication
        - name: tiers
          in: query
          required: false
          description: Inclui os volume tiers (preço menor em volume maior) na resposta.
          schema:
            type: boolean
          example: true
      responses:
        '200':
          description: >-
            O preço flat do mercado+moeda+categoria, ou metadados quando chamado
            sem parâmetros.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    title: Price
                    properties:
                      market:
                        type: string
                      marketName:
                        type: string
                      currency:
                        type: string
                      category:
                        type: string
                        enum:
                          - marketing
                          - utility
                          - authentication
                          - service
                          - authentication_international
                      pricePerMessage:
                        type: number
                        description: >-
                          Preço de tabela por mensagem entregue, na moeda
                          solicitada. 0 = grátis (Serviço).
                      volumeTiers:
                        type: array
                        description: >-
                          Presente só com tiers=true. Preço menor em volume
                          mensal maior.
                        items:
                          type: object
                          properties:
                            from:
                              type: integer
                            to:
                              type:
                                - integer
                                - 'null'
                              description: null = faixa mais alta, sem limite superior
                            pricePerMessage:
                              type: number
                  - type: object
                    title: Metadata
                    properties:
                      markets:
                        type: array
                        items:
                          type: object
                          properties:
                            code:
                              type: string
                            name:
                              type: string
                      currencies:
                        type: array
                        items:
                          type: string
                      categories:
                        type: array
                        items:
                          type: string
                      source:
                        type: string
              examples:
                price:
                  summary: Preço flat
                  value:
                    market: BR
                    marketName: Brazil
                    currency: BRL
                    category: authentication
                    pricePerMessage: 0.035
                price_with_tiers:
                  summary: Com ?tiers=1
                  value:
                    market: BR
                    marketName: Brazil
                    currency: BRL
                    category: authentication
                    pricePerMessage: 0.035
                    volumeTiers:
                      - from: 0
                        to: 500000
                        pricePerMessage: 0.035
                      - from: 500001
                        to: null
                        pricePerMessage: 0.0263
                metadata:
                  summary: Metadados (sem parâmetros)
                  value:
                    markets:
                      - code: BR
                        name: Brazil
                      - code: NAM
                        name: North America
                    currencies:
                      - USD
                      - AED
                      - ARS
                      - AUD
                      - BRL
                      - CLP
                      - COP
                      - EUR
                      - GBP
                      - IDR
                      - INR
                      - MXN
                      - MYR
                      - PEN
                      - SAR
                      - SGD
                    categories:
                      - marketing
                      - utility
                      - authentication
                      - service
                      - authentication_international
                    source: whatsappbusiness.com
        '400':
          description: >-
            MARKET_CURRENCY_CATEGORY_REQUIRED (parâmetros parciais) ou
            INVALID_CATEGORY.
        '401':
          description: Header x-api-key ausente ou inválido.
        '404':
          description: >-
            PRICE_NOT_FOUND - sem rate publicada para esse
            mercado+moeda+categoria.
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)

````

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