> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crbtrack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Single Tracking

> Get tracking information for a single parcel

Retrieves the current status and optional history for a single parcel.

## Path Parameters

<ParamField path="trackingNumber" type="string" required>
  The tracking number to look up (10-30 characters).
</ParamField>

## Query Parameters

<ParamField query="includeHistory" type="boolean" default="false">
  Set to `true` to include the full tracking history.
</ParamField>

## Response

<ResponseField name="trackingNumber" type="string">
  The tracking number
</ResponseField>

<ResponseField name="status" type="string">
  Current status code (e.g., `IN_TRANSIT`)
</ResponseField>

<ResponseField name="statusName" type="string">
  Human-readable status name
</ResponseField>

<ResponseField name="estimatedDelivery" type="string">
  Estimated delivery date (ISO 8601)
</ResponseField>

<ResponseField name="history" type="array">
  Tracking history events (if `includeHistory=true`)

  <Expandable title="Event fields">
    <ResponseField name="status" type="string">
      Status code at this event
    </ResponseField>

    <ResponseField name="statusName" type="string">
      Human-readable status
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      When this event occurred
    </ResponseField>

    <ResponseField name="location" type="string">
      Location of the event
    </ResponseField>

    <ResponseField name="description" type="string">
      Additional details
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.crbtrack.com/api/v1/tracking/CBECUSD123456789?includeHistory=true" \
    -H "X-API-Key: <YOUR_API_KEY>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "trackingNumber": "CBECUSD123456789",
    "status": "IN_TRANSIT",
    "statusName": "In Transit",
    "estimatedDelivery": "2024-12-28T18:00:00Z",
    "history": [
      {
        "status": "ORDERED",
        "statusName": "Order Created",
        "timestamp": "2024-12-21T10:30:00Z",
        "location": "Miami, FL, US"
      },
      {
        "status": "LABEL_GENERATED",
        "statusName": "Label Generated",
        "timestamp": "2024-12-21T10:30:05Z",
        "location": "Miami, FL, US"
      },
      {
        "status": "CUSTOMS_CLEARANCE",
        "statusName": "Customs Clearance",
        "timestamp": "2024-12-23T08:00:00Z",
        "location": "Miami, FL, US"
      },
      {
        "status": "IN_TRANSIT",
        "statusName": "In Transit",
        "timestamp": "2024-12-24T14:30:00Z",
        "location": "Quito, EC",
        "description": "Package departed from sorting facility"
      }
    ]
  }
  ```

  ```json 404 - Not Found theme={null}
  {
    "success": false,
    "error": {
      "code": "PARCEL_NOT_FOUND",
      "message": "No parcel found with tracking number INVALID123",
      "message_es": "No se encontró un paquete con el número de seguimiento INVALID123",
      "requestId": "req_abc123"
    }
  }
  ```
</ResponseExample>

## Status Codes

| Status               | Description                   |
| -------------------- | ----------------------------- |
| `ORDERED`            | Order created, awaiting label |
| `LABEL_GENERATED`    | Shipping label created        |
| `MANIFEST_SUBMITTED` | Added to manifest/AWB         |
| `PICKED_UP`          | Collected by carrier          |
| `CUSTOMS_CLEARANCE`  | Processing at customs         |
| `IN_TRANSIT`         | On the way to destination     |
| `OUT_FOR_DELIVERY`   | With delivery driver          |
| `DELIVERED`          | Successfully delivered        |
| `DELIVERY_FAILED`    | Delivery attempt unsuccessful |
| `RETURN_TO_SENDER`   | Being returned to sender      |
| `VOIDED`             | Order cancelled               |