> ## 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.

# Get Label

> Get label metadata and download URL

Retrieves information about a shipping label, including the download URL.

## Path Parameters

<ParamField path="trackingNumber" type="string" required>
  The tracking number of the parcel.
</ParamField>

## Response

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

<ResponseField name="labelUrl" type="string">
  URL to download the label (valid for 24 hours)
</ResponseField>

<ResponseField name="format" type="string">
  Label format: `PDF`, `ZPL`, or `PNG`
</ResponseField>

<ResponseField name="createdAt" type="string">
  When the label was generated
</ResponseField>

<ResponseField name="printCount" type="integer">
  Number of times the label has been downloaded
</ResponseField>

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

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "trackingNumber": "CBECUSD123456789",
    "labelUrl": "https://labels.crbtrack.com/CBECUSD123456789.pdf?token=abc123",
    "format": "PDF",
    "createdAt": "2024-12-21T10:30:00Z",
    "printCount": 1
  }
  ```

  ```json 404 - Not Found theme={null}
  {
    "success": false,
    "error": {
      "code": "LABEL_NOT_FOUND",
      "message": "No label found for this tracking number",
      "message_es": "No se encontró etiqueta para este número de seguimiento",
      "requestId": "req_abc123"
    }
  }
  ```
</ResponseExample>