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

> Preco por mensagem publicado do Meta / WhatsApp Business Platform para um unico mercado + moeda + categoria. Dado de referencia global - NAO e a cobranca real do tenant. Chame sem parametros para metadados (mercados, moedas, categorias). Envie market + currency + category para o preco flat; adicione tiers=true para os volume tiers. Qualquer API key valida 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: Preco de mensagem
      description: >-
        Preco por mensagem publicado do Meta / WhatsApp Business Platform para
        um unico mercado + moeda + categoria. Dado de referencia global - NAO e
        a cobranca real do tenant. Chame sem parametros para metadados
        (mercados, moedas, categorias). Envie market + currency + category para
        o preco flat; adicione tiers=true para os volume tiers. Qualquer API key
        valida funciona.
      operationId: get_meta_pricing
      parameters:
        - name: market
          in: query
          required: false
          description: >-
            Codigo do mercado. Codigos: AR Argentina, BR Brazil, CL Chile, CO
            Colombia, EG Egypt, FR France, DE Germany, HK Hong Kong, HU Hungary,
            IN India, ID Indonesia, IL Israel, IT Italy, MY Malaysia, MX Mexico,
            NL Netherlands, NG Nigeria, NAM North America, PK Pakistan, PE Peru,
            PL Poland, QA Qatar, RO Romania, RU Russia, SA Saudi Arabia, SG
            Singapore, ZA South Africa, ES Spain, TR Turkey, AE United Arab
            Emirates, GB United Kingdom, GLO Other, AFR Rest of Africa, APAC
            Rest of Asia Pacific, CEEU Rest of Central & Eastern Europe, LATAM
            Rest of Latin America, MDE Rest of Middle East, WEU Rest of Western
            Europe.
          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 (obrigatoria 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 (preco menor em volume maior) na resposta.
          schema:
            type: boolean
          example: true
      responses:
        '200':
          description: >-
            O preco flat do mercado+moeda+categoria, ou metadados quando chamado
            sem parametros.
          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: >-
                          List price per delivered message in the requested
                          currency. 0 = free (Service).
                      volumeTiers:
                        type: array
                        description: >-
                          Only present with tiers=true. Cheaper price at higher
                          monthly volume.
                        items:
                          type: object
                          properties:
                            from:
                              type: integer
                            to:
                              type:
                                - integer
                                - 'null'
                              description: null = unbounded top tier
                            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: Flat price
                  value:
                    market: BR
                    marketName: Brazil
                    currency: BRL
                    category: authentication
                    pricePerMessage: 0.035
                price_with_tiers:
                  summary: With ?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: Metadata (no params)
                  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 (parametros parciais) ou
            INVALID_CATEGORY.
        '401':
          description: Header x-api-key ausente ou invalido.
        '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)

````