---
title: "Search shipments, containers, and tracking requests"
method: GET
path: "/search"
tags: ["Search"]
---

# Search shipments, containers, and tracking requests

`GET /search`

Full-text search across shipments, containers (cargos), and tracking requests within your account. Results are ranked by type (shipments first, then containers, then tracking requests) and recency. Returns up to 25 results. Duplicate tracking requests (where a shipment exists with the same BL number) are automatically filtered out.

## Query parameters

- `query` string, required

## Response `200`

Successful search results

- object
  - `data` object[]
    - `id` string — Unique identifier of the matched resource
    - `type` 'shipment' | 'cargo' | 'tracking_request' — Resource type
    - `attributes` object
      - `entity_type` string — Type of the matched entity: `shipment`, `cargo`, or `tracking_request`
      - `number` string — BL number (shipments), container number (cargos), or request number (tracking requests)
      - `shipment_id` string, nullable — Associated shipment ID (for cargos and tracking requests only)
      - `scac` string, nullable — Standard Carrier Alpha Code of the shipping line
      - `port_of_lading_name` string, nullable — Port of lading name (shipments only)
      - `port_of_discharge_name` string, nullable — Port of discharge name (shipments only)
      - `containers_count` integer, nullable — Number of containers on the shipment (shipments only)
      - `tracking_stopped` boolean, nullable — Whether tracking has been stopped (shipments only)
      - `tracking_stopped_reason` string, nullable — Reason tracking was stopped (shipments only)
      - `status` string, nullable — Tracking request status (tracking requests only)
      - `failed_reason` string, nullable — Reason the tracking request failed (tracking requests only)
      - `ref_numbers` string[] — Customer reference numbers
      - `created_at` string, date-time — When the resource was created
      - `updated_at` string, date-time — When the resource was last updated

## Other responses

- `400` — Bad request — missing required `query` parameter
- `401` — Unauthorized — missing or invalid API token

---

[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)