Skip to main content
GET
/
api
/
v1
/
envios
/
seguimiento
/
{codigo}
Track Shipment
curl --request GET \
  --url https://api.example.com/api/v1/envios/seguimiento/{codigo}
{
  "codigoSeguimiento": "<string>",
  "estado": "<string>",
  "fechaEnvio": "<string>",
  "fechaEntrega": "<string>",
  "precio": 123,
  "nombreDestinatario": "<string>",
  "origen": {
    "origen.codigoSucursal": "<string>",
    "origen.nombreSucursal": "<string>",
    "origen.ciudad": "<string>"
  },
  "destino": {},
  "encomienda": {
    "encomienda.peso": 123,
    "encomienda.dimensiones": "<string>",
    "encomienda.descripcion": "<string>"
  }
}

​
Endpoint

GET /api/v1/envios/seguimiento/{codigo}
Retrieve public tracking information for a shipment using its tracking code. This endpoint returns limited information suitable for public tracking portals.

​
Path Parameters

​
codigo
string
required
The unique tracking code of the shipment (e.g., “ENV-20260309-ABCD1234”)

​
Response

​
codigoSeguimiento
string
Tracking code
​
estado
string
Current shipment status: PENDIENTE, EN_TRANSITO, DISPONIBLE, ENTREGADO, or CANCELADO
​
fechaEnvio
string
Date and time when the shipment was created
​
fechaEntrega
string
Date and time when the shipment was delivered (null if not yet delivered)
​
precio
number
Shipment price
​
nombreDestinatario
string
Recipient’s full name
​
origen
object
Origin branch office information
​
origen.codigoSucursal
string
Branch code
​
origen.nombreSucursal
string
Branch name
​
origen.ciudad
string
City name
​
destino
object
Destination branch office information
​
encomienda
object
Package information
​
encomienda.peso
number
Package weight in kg
​
encomienda.dimensiones
string
Package dimensions
​
encomienda.descripcion
string
Package description

​
Example Request

curl -X GET http://localhost:8080/api/v1/envios/seguimiento/ENV-20260309-ABCD1234

​
Example Response

{
  "codigoSeguimiento": "ENV-20260309-ABCD1234",
  "estado": "EN_TRANSITO",
  "fechaEnvio": "2026-03-09T10:30:00",
  "fechaEntrega": null,
  "precio": 25.50,
  "nombreDestinatario": "Juan Pérez",
  "origen": {
    "codigoSucursal": "LIM-001",
    "nombreSucursal": "Lima Centro",
    "ciudad": "Lima"
  },
  "destino": {
    "codigoSucursal": "CUS-001",
    "nombreSucursal": "Cusco Principal",
    "ciudad": "Cusco"
  },
  "encomienda": {
    "peso": 2.5,
    "dimensiones": "30x40x20 cm",
    "descripcion": "Documentos importantes"
  }
}

​
Error Response

If the tracking code is not found: 
{
  "error": "EnvioNotFoundException",
  "message": "Envío no encontrado con código: ENV-20260309-ABCD1234"
}
This endpoint returns public information only. Sensitive data like sender details and delivery password are not included.

​
Shipment Status Meanings

  • PENDIENTE: Shipment has been registered and is awaiting processing
  • EN_TRANSITO: Shipment is in transit to the destination
  • DISPONIBLE: Shipment has arrived and is available for pickup
  • ENTREGADO: Shipment has been successfully delivered to the recipient
  • CANCELADO: Shipment has been cancelled

Build docs developers (and LLMs) love

Get started for freeTalk to us