Endpoints
Base URL: https://www.theseller.com.br
Authentication: none. JSON responses with CORS enabled.
Estimate message cost
GET /api/v1/whatsapp-pricing/simulate
Calculates Meta's fee (with volume tiers), The Seller's fee and the total and average cost per message, in Brazilian reais.
Parameters
quantity: required. Number of messages (1 to 1,000,000,000).category: marketing (default), utility or authentication.currency: Meta account currency: BRL (default) or USD.exchangeRate: BRL per USD, used when currency=USD. Default 5.4.
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/simulate?quantity=10000&category=marketing"
Rate card
GET /api/v1/whatsapp-pricing/rates
Returns Meta's list rates and volume tiers for Brazil, The Seller's fee and the official sources.
curl "https://www.theseller.com.br/api/v1/whatsapp-pricing/rates"
Example response
{
"input": {
"quantity": 10000,
"category": "marketing",
"currency": "BRL",
"exchangeRate": 5.4,
"market": "brazil"
},
"meta": {
"currency": "BRL",
"cost": 3217,
"costBRL": 3217,
"effectiveRate": 0.3217,
"tiers": [
{
"quantity": 10000,
"rate": 0.3217,
"cost": 3217,
"from": 1,
"to": 10000
}
]
},
"theSeller": {
"ratePerMessageBRL": 0.1,
"costBRL": 1000
},
"totalCostBRL": 4217,
"averageCostPerMessageBRL": 0.4217,
"rateCardUpdatedAt": "setembro de 2026",
"notes": [
"Estimate only. Meta bills its fee directly in the account currency; the final amount depends on Meta's rate card on the billing date.",
"Service (user-initiated) conversations are not included."
]
}
Errors
Errors are always JSON, with a stable code, a message, a hint on how to fix the request and a link to these docs. Codes: invalid_parameter and missing_parameter (400), not_found (404) and method_not_allowed (405).
{
"error": {
"code": "invalid_parameter",
"message": "category must be one of: marketing, utility, authentication.",
"hint": "Use the Meta template category of the message.",
"docs": "https://www.theseller.com.br/developers",
"parameter": "category"
}
}
