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

# Parcel Tracking

> Track shipments using carrier search and delivery status tools.

Use Parcel Tracking to retrieve real-time shipment tracking information through
a parcel tracking provider.

## Supported tools

<AccordionGroup>
  <Accordion title="get_official_carrier_name">
    Search carriers by name keyword (supports fuzzy typos). Use this when you need the “official” carrier name to pass to tracking.

    | Parameter | Description                                                        | Required | Default |
    | :-------- | :----------------------------------------------------------------- | :------: | :------ |
    | `query`   | Keyword to search carrier names (case-insensitive, typos allowed). |    Yes   |         |
    | `limit`   | Max number of results to return.                                   |    No    | `10`    |

    **Output**: JSON string containing a list of matching official carrier names.
  </Accordion>

  <Accordion title="track_parcel_delivery_status">
    Track a parcel / shipment delivery status.

    | Parameter      | Description                                                                                                              | Required | Default |
    | :------------- | :----------------------------------------------------------------------------------------------------------------------- | :------: | :------ |
    | `number`       | The tracking number of the parcel.                                                                                       |    Yes   |         |
    | `carrier_name` | Optional carrier name. If carrier auto-detect fails, use `get_official_carrier_name` to find the correct name and retry. |    No    | `""`    |

    **Output**: JSON string containing tracking information (or an error message).
  </Accordion>
</AccordionGroup>

## Typical flow

1. Call `track_parcel_delivery_status` with the tracking number.
2. If you get a “carrier not found” error, call `get_official_carrier_name` with
   a carrier keyword (for example, “DHL”).
3. Retry `track_parcel_delivery_status` with `carrier_name` set to the official
   carrier name.