Referencia de la API

Seguimiento público

El estado de un envío tal como lo ve el destinatario, sin credenciales.

get
/v2/packages/find/{followingNumber}https://api.beartrackapp.com/api/v1

Devuelve el estado actual del envío, su historial, el destinatario y la dirección de entrega: exactamente lo que muestra la página pública de seguimiento. Sirve para armar tu propia página de seguimiento. Para integrar, usa Consultar pedido, que trae el identificador, tu order_id y la evidencia de entrega.

Autenticación

Este endpoint no requiere credenciales.

El número de seguimiento es el único secreto: cualquiera que lo tenga puede consultar el pedido. Es el mismo comportamiento de la página pública de seguimiento.

Parámetros de ruta

followingNumberstringrequerido

Número de seguimiento del pedido: el following_number que devuelve la creación.

Ejemplo

curl -X GET 'https://api.beartrackapp.com/api/v1/v2/packages/find/268012'

Respuestas

200OK

Pedido encontrado.

Ejemplo
{
  "followingNumber": 268012,
  "status": 4,
  "lastStatusChange": "2026-10-20T18:42:11.056Z",
  "createdAt": "2026-10-20T12:05:37.059Z",
  "updatedAt": "2026-10-20T18:42:11.434Z",
  "receiver_name": "MARÍA",
  "receiver_lastName": "MUÑOZ",
  "receiver_phone": "+56942405123",
  "realReceiver": {
    "name": "María",
    "lastName": "Muñoz"
  },
  "shipping_address": {
    "address_line": "Avenida Siempre Viva 742",
    "street_name": "Avenida Siempre Viva",
    "municipality": {
      "name": "Ñuñoa"
    },
    "city": {
      "name": "Región Metropolitana"
    },
    "country": {
      "name": "Chile"
    }
  },
  "senderInfo": {
    "senderState": "RM"
  },
  "packageStatusHistory": [
    {
      "status": 0,
      "updatedAt": "2026-10-20T12:05:37.056Z"
    },
    {
      "status": 100,
      "updatedAt": "2026-10-20T12:31:02.118Z"
    },
    {
      "status": 1,
      "updatedAt": "2026-10-20T14:10:45.902Z"
    },
    {
      "status": 2,
      "updatedAt": "2026-10-20T15:02:19.377Z"
    },
    {
      "status": 3,
      "updatedAt": "2026-10-20T16:20:08.640Z"
    },
    {
      "status": 4,
      "updatedAt": "2026-10-20T18:42:11.056Z"
    }
  ],
  "courier_website": "www.beartrackapp.com",
  "support_phone_number": "+56932335468",
  "logo": "https://f005.backblazeb2.com/file/ots-prd/static-files/cbimage.png",
  "international_or_domestic": "Domestic",
  "integration_method": "API",
  "integration_credentials": "No",
  "integration_docs": "https://api.beartrackapp.com/api/v1/v2/api-docs/",
  "web_track_URL": "https://www.beartrackapp.com/tracking",
  "five_tracking_numbers": "",
  "supports_last_mile_tracking": "Yes",
  "utc_offset": "UTC -3",
  "weight_unit": "",
  "insurance": "",
  "currency": "CLP",
  "events_checkpoints": ""
}
404Not Found
  • Pedido no encontrado

    The package you are looking for does not exist.

    No hay ningún paquete con ese número de seguimiento.

Notas

  • Este endpoint no pide credenciales: el número de seguimiento es el secreto. No lo publiques en páginas indexables si no quieres que el pedido sea consultable.
  • Por ser público, no devuelve _id, order_id, el repartidor ni la evidencia de entrega. Un campo que no está en el ejemplo no viene en la respuesta. Esos datos están en Consultar pedido, con tu token.
  • status es el estado actual y packageStatusHistory trae cada cambio con su fecha. Qué significa cada código, incluido el 100, está en Estados del envío.
  • realReceiver es quién recibió el paquete. Viene vacío ({}) hasta la entrega.
  • Los campos desde courier_website hasta events_checkpoints no describen el envío: existen para agregadores de seguimiento. support_phone_number es el teléfono de soporte de tu operador; el resto no te sirve para integrar.