Monthly plan
R$ 114/mo
11k requests/month
- Cost by volume
- R$ 10.26 per 1,000 requests
- Savings
- Save 15%
- Yearly savings
- Save R$ 232/year
Wonca Labs
Tracking API
Keep customers informed without leaving your product.
Automate Correios, CAINIAO, USPS, J&T Express, FedEx, UPS and more lookups in your store, ERP, dropshipping spreadsheets, apps or automated support.
Join more than 2,000 customers and users.
POST /Track
JSONcurl -X POST \
https://api.wonca.com.br/\
wonca.labs.v1.LabsService/Track \
-H "Authorization: Apikey YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"code":"AA361812099BR"}'HTTPS + JSON + a key from your dashboard
Information in the right place
Tracking that keeps customers in your product
Show parcel status on the order page, in your app or in the support channel your customer already uses.
The same response can feed your ERP, logistics operation and internal automations. Your team decides where each update shows up.
What it covers
Automate lookups across 15 carriers
Look up one code, process batches or follow changes with monitoring and webhooks.
Correios, CAINIAO, USPS, J&T Express, FedEx, UPS, Evri, DPD, OnTrac, Yodel, La Poste, GLS, CTT Express, Aramex, and Total Express
Supported carriers
See the USPS tracking APISingle lookup
Look up a code from any of the 15 carriers and use the JSON response in your product.
Batch lookups
Look up several codes in one call when you have more than one parcel.
Monitoring and webhooks
Monitor codes and receive updates at the endpoint you register.
API plans
Pick the allowance that fits your operation
Compare monthly volume, cost per thousand requests and the savings of each plan.
Monthly subscription billed in BRL. The allowance renews every billing cycle.
Monthly plan
Most popularR$ 285/mo
33k requests/month
- Cost by volume
- R$ 8.55 per 1,000 requests
- Savings
- Save 29%
- Yearly savings
- Save R$ 1,380/year
Monthly plan
R$ 570/mo
101k requests/month
- Cost by volume
- R$ 5.64 per 1,000 requests
- Savings
- Save 53%
- Yearly savings
- Save R$ 7,705/year
Monthly plan
R$ 1,140/mo
267k requests/month
- Cost by volume
- R$ 4.28 per 1,000 requests
- Savings
- Save 64%
- Yearly savings
- Save R$ 24,720/year
Monthly plan
R$ 2,850/mo
1M requests/month
- Cost by volume
- R$ 2.85 per 1,000 requests
- Savings
- Save 76%
- Yearly savings
- Save R$ 109,800/year
Plan
Custom
- Volume that fits you
- Flexible pricing
- Direct support
- Tailored solution
How to integrate
From key to first response
The docs cover request formats and examples to bring the call into your backend.
Open the technical guide- 01
Create a key in the dashboard
Use the key to authenticate the calls from your system.
- 02
Send the tracking code
Make an HTTPS request with JSON and the key in the Authorization header.
- 03
Use the response in your product
Connect the data to your order page, support desk or automation.
Readable response
A direct contract for your backend
A delivered SEDEX parcel, exactly as the API returns it. Three top-level fields and the carrier data ready to store.
- carrier
- The carrier that answered the lookup.
- status
- Found, not found or unavailable right now.
- payload
- Carrier data, with events from newest to oldest.
POST /Track · AA361812099BR200 OK
{
"carrier": "CARRIER_CORREIOS",
"status": "TRACKING_STATUS_FOUND",
"payload": {
"codObjeto": "AA361812099BR",
"tipoPostal": {
"sigla": "AA",
"descricao": "ETIQUETA LOGICA SEDEX",
"categoria": "SEDEX"
},
"dtPrevista": "13/11/2026",
"situacao": "E",
"eventos": [
{
"codigo": "BDE",
"tipo": "01",
"dtHrCriado": {
"date": "2026-11-12 14:32:08.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"descricao": "Objeto entregue ao destinatário",
"unidade": {
"tipo": "Unidade de Distribuição",
"endereco": { "cidade": "SAO PAULO", "uf": "SP" }
}
},
{
"codigo": "OEC",
"tipo": "01",
"dtHrCriado": {
"date": "2026-11-12 08:14:51.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"descricao": "Objeto saiu para entrega ao destinatário",
"unidade": {
"tipo": "Unidade de Distribuição",
"endereco": { "cidade": "SAO PAULO", "uf": "SP" }
}
}
]
}
}Shortened response. Addresses, coordinates and every other field are in the technical reference.
FAQ
Before you connect
How do I start using the API?
Go to Wonca Labs, create a key in the dashboard and follow the examples in the docs. Keep the key safe on your server.
Which carriers are supported?
The Wonca Labs tracking API looks up codes from Correios, CAINIAO, USPS, J&T Express, FedEx, UPS, Evri, DPD, OnTrac, Yodel, La Poste, GLS, CTT Express, Aramex, and Total Express. For now, J&T Express covers Brazil only, DPD the United Kingdom only and GLS Italy only.
Can I look up several codes at once?
Yes. There are calls for single and batch lookups. The docs describe the format of each request.
How do I get tracking updates?
Set up monitoring and webhooks in Wonca Labs. Updates are sent to the endpoint you register.
Does the API work with my stack?
If your system can send HTTPS requests and read JSON, it can use the API.
How do I reach the sales team?
Send your use case and the systems involved through the contact form. The team will talk the integration through with you.
Next call
Automate parcel tracking in your product.
Create your key in the dashboard to get started, or talk to sales about your use case.