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

> Published Meta / WhatsApp Business Platform per-message rate for a single market + currency + category. Global reference data - NOT the tenant's real billing. Call with no params for metadata (available markets, currencies, categories). Provide market + currency + category for the flat price; add tiers=true for volume tiers. Any valid API key works.



## OpenAPI

````yaml openapi.json GET /v1/meta/pricing
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/meta/pricing:
    get:
      tags:
        - Pricing
      summary: Message rate
      description: >-
        Published Meta / WhatsApp Business Platform per-message rate for a
        single market + currency + category. Global reference data - NOT the
        tenant's real billing. Call with no params for metadata (available
        markets, currencies, categories). Provide market + currency + category
        for the flat price; add tiers=true for volume tiers. Any valid API key
        works.
      operationId: get_meta_pricing
      parameters:
        - name: market
          in: query
          required: false
          description: >-
            Market code. Codes: 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: ISO 4217 currency.
          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: Message category (required together with market + currency).
          schema:
            type: string
            enum:
              - marketing
              - utility
              - authentication
              - service
              - authentication_international
          example: authentication
        - name: tiers
          in: query
          required: false
          description: >-
            Include the volume tiers (cheaper price at higher monthly volume) in
            the response.
          schema:
            type: boolean
          example: true
      responses:
        '200':
          description: >-
            The flat price for the market+currency+category, or metadata when
            called with no params.
          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 (partial params) or
            INVALID_CATEGORY.
        '401':
          description: Missing or invalid x-api-key header.
        '404':
          description: >-
            PRICE_NOT_FOUND - no published rate for that
            market+currency+category.
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)

````