Eventos de rastreio do pedido
curl --request GET \
--url https://apiv3.usecorvex.com.br/api/v1/orders/{orderId}/tracking \
--header 'Authorization: Bearer <token>' \
--header 'X-Store-Id: <x-store-id>'const options = {
method: 'GET',
headers: {'X-Store-Id': '<x-store-id>', Authorization: 'Bearer <token>'}
};
fetch('https://apiv3.usecorvex.com.br/api/v1/orders/{orderId}/tracking', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/orders/{orderId}/tracking"
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"events": [
{
"status": "posted",
"label": "Postado",
"previousStatus": "label_generated",
"previousLabel": "Etiqueta gerada",
"createdAt": "2026-09-22T10:00:00.000Z",
"occurredAt": "2026-09-22T09:40:00.000Z",
"locationLabel": "São Paulo / SP",
"latitude": -23.55,
"longitude": -46.63,
"carrier": "correios",
"trackingCode": "AB123456789BR",
"source": "carrier",
"provider": "correios",
"replayed": false,
"retryCount": 0,
"processingState": "processed"
},
{
"status": "in_transit",
"label": "Em trânsito",
"previousStatus": "posted",
"previousLabel": "Postado",
"createdAt": "2026-09-24T14:00:00.000Z",
"occurredAt": "2026-09-24T14:00:00.000Z",
"locationLabel": "Campinas / SP",
"latitude": -22.9,
"longitude": -47.06,
"carrier": "correios",
"trackingCode": "AB123456789BR",
"source": "carrier",
"provider": "correios",
"replayed": false,
"retryCount": 0,
"processingState": "processed"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 2,
"totalPages": 1
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"error": {
"message": "Recurso não encontrado",
"code": "RESOURCE_NOT_FOUND"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 404
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Rastreio
Eventos de rastreio do pedido
GET
/
api
/
v1
/
orders
/
{orderId}
/
tracking
Eventos de rastreio do pedido
curl --request GET \
--url https://apiv3.usecorvex.com.br/api/v1/orders/{orderId}/tracking \
--header 'Authorization: Bearer <token>' \
--header 'X-Store-Id: <x-store-id>'const options = {
method: 'GET',
headers: {'X-Store-Id': '<x-store-id>', Authorization: 'Bearer <token>'}
};
fetch('https://apiv3.usecorvex.com.br/api/v1/orders/{orderId}/tracking', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/orders/{orderId}/tracking"
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"events": [
{
"status": "posted",
"label": "Postado",
"previousStatus": "label_generated",
"previousLabel": "Etiqueta gerada",
"createdAt": "2026-09-22T10:00:00.000Z",
"occurredAt": "2026-09-22T09:40:00.000Z",
"locationLabel": "São Paulo / SP",
"latitude": -23.55,
"longitude": -46.63,
"carrier": "correios",
"trackingCode": "AB123456789BR",
"source": "carrier",
"provider": "correios",
"replayed": false,
"retryCount": 0,
"processingState": "processed"
},
{
"status": "in_transit",
"label": "Em trânsito",
"previousStatus": "posted",
"previousLabel": "Postado",
"createdAt": "2026-09-24T14:00:00.000Z",
"occurredAt": "2026-09-24T14:00:00.000Z",
"locationLabel": "Campinas / SP",
"latitude": -22.9,
"longitude": -47.06,
"carrier": "correios",
"trackingCode": "AB123456789BR",
"source": "carrier",
"provider": "correios",
"replayed": false,
"retryCount": 0,
"processingState": "processed"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 2,
"totalPages": 1
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"error": {
"message": "Recurso não encontrado",
"code": "RESOURCE_NOT_FOUND"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 404
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Authorizations
API Key no formato cvx_live_..., criada no painel Corvex. Não use JWT de sessão nem x-api-key.
Headers
UUID da loja. A chave precisa ter esta loja autorizada.
Path Parameters
Response
Timeline de rastreio.