---
title: "List tracking requests"
method: GET
path: "/tracking_requests"
tags: ["Tracking Requests"]
---

# List tracking requests

`GET /tracking_requests`

Returns a list of your tracking requests. The tracking requests are returned sorted by creation date, with the most recent tracking request appearing first.

## Query parameters

- `q` string
- `filter[request_number]` string
- `filter[status]` 'created' | 'pending' | 'failed'
- `filter[scac]` string
- `filter[created_at][start]` string, date-time
- `filter[created_at][end]` string, date-time
- `filter[updated_at][start]` string, date-time
- `filter[updated_at][end]` string, date-time
- `include` string
- `page[number]` integer
- `page[size]` integer

## Response `200`

OK

- object
  - `data` TrackingRequest[]
    - `id` string, uuid, required
    - `type` 'tracking_request', required
    - `attributes` object
      - `request_number` string, required
      - `ref_numbers` string[], nullable
      - `tags` string[]
      - `status` 'pending' | 'awaiting_manifest' | 'created' | 'failed' | 'tracking_stopped', required
      - `failed_reason` 'booking_cancelled' | 'duplicate' | 'expired' | 'internal_processing_error' | 'invalid_number' | 'not_found' | 'retries_exhausted' | 'shipping_line_unreachable' | 'unrecognized_response' | 'data_unavailable' | 'scac_auto_detect_failed' | 'null', nullable — If the tracking request has failed, or is currently failing, the last reason we were unable to complete the request. `scac_auto_detect_failed` means `auto_detect_vocc_scac` was set but no supported carrier SCAC could be inferred from the request number.
      - `request_type` 'bill_of_lading' | 'booking_number' | 'container', required
      - `scac` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time
      - `is_retrying` boolean
      - `retry_count` integer, nullable — How many times T49 has attempted to get the shipment from the shipping line
    - `relationships` object
      - `tracked_object` object
        - `data` object, nullable
          - `id` string, uuid
          - `type` 'shipment'
      - `customer` object
        - `data` object
          - `id` string, uuid
          - `type` 'party'
  - `links` Links
    - `last` string, uri
    - `next` string, uri
    - `prev` string, uri
    - `first` string, uri
    - `self` string, uri
  - `meta` Meta
    - `size` integer
    - `total` integer
  - `included` union[]
    - union
      - Account
        - `id` string, uuid, required
        - `type` 'account', required
        - `attributes` object, required
          - `company_name` string, required
      - ShippingLine
        - `id` string, uuid, required
        - `attributes` object, required
          - `scac` string, required
          - `name` string, required
          - `alternative_scacs` string[], required — Additional SCACs which will be accepted in tracking requests
          - `short_name` string, required
          - `bill_of_lading_tracking_support` boolean, required
          - `booking_number_tracking_support` boolean, required
          - `container_number_tracking_support` boolean, required
        - `type` 'shipping_line', required
      - object
        - `id` string, uuid
        - `type` 'shipment'
        - `links` object
          - `self` string, uri

## Other responses

- `404` — Not Found

---

[API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/998a27e39c03/schema)