---
title: "Get available shipment tracking methods for a carrier"
method: GET
path: "/api/v4/tl/shipments/trackingmethods"
tags: ["TL: Tracking"]
---

# Get available shipment tracking methods for a carrier

`GET /api/v4/tl/shipments/trackingmethods`

## Request

- Base URL: `https://na12.api.project44.com`
- URL: `https://na12.api.project44.com/api/v4/tl/shipments/trackingmethods`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/v4/oauth2/token`
- TypeScript: <https://skmtc.dev/project44/apis/project44-rest-api/docs/api/v4/tl/shipments/trackingmethods/get.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to return available shipment tracking methods for a given carrier.<h4><b>Required Fields</h4></b>
<ul><li> carrierIdentifier.type </li><li> carrierIdentifier.value </li></ul>

## Query parameters

- `carrierIdentifier.type` 'SCAC' | 'DOT_NUMBER' | 'MC_NUMBER' | 'P44_EU' | 'SYSTEM' | 'P44_GLOBAL' | 'VAT'
- `carrierIdentifier.value` string

## Response `200`

OK

- TruckloadShipmentTrackingMethods
  - `trackingMethods` TruckloadShipmentTrackingMethod[]: An ordered list of tracking methods that can be used to track a shipment, with the most robust method available listed first. When creating a shipment, provide as many shipment identifiers and equipment identifiers as possible that match the ones in the tracking methods in this list, preferring ones first in the list over others. Each tracking method will contain either a shipment identifier or an equipment identifier, or both.
    - `capacityProviderAccount` CapacityProviderAccount: The capacity provider account that was used for authentication with the capacity provider's API.
      - `code` string: The code for the requested capacity provider account that was used for authentication with the capacity provider's API.
    - `equipmentIdentifier` TruckloadEquipmentIdentifier
      - `shouldDelete` boolean: Optional field indicating whether equipment identifier should be deleted.
      - `type` 'MOBILE_PHONE_NUMBER' | 'VEHICLE_ID' | 'LICENSE_PLATE' | 'SENSITECH_DEVICE_ID' | 'TIVE_DEVICE_ID': The type of the equipment identifier.
      - `value` string: The value of the equipment identifier. Cell phone numbers will be obfuscated in project44 responses for privacy reasons.
    - `infoMessages` Message[]: System messages and messages from the capacity provider with severity 'INFO' or 'WARNING'. No messages with severity 'ERROR' will be returned here. These will provide more details about the shipment identifier and/or equipment identifier to provide.
      - `diagnostic` string: Diagnostic information, often originating from the capacity provider.
      - `message` string: Message informational text.
      - `severity` 'ERROR' | 'WARNING' | 'INFO': The severity of this message.
      - `source` 'SYSTEM' | 'CAPACITY_PROVIDER': The originator of this message -- either project44 (the system) or the capacity provider.
    - `shipmentIdentifier` TruckloadShipmentIdentifier
      - `type` 'BILL_OF_LADING' | 'ORDER': The type of the shipment identifier.
      - `value` string: The value of the shipment identifier.

## Other responses

- `400`: Invalid request
- `401`: Invalid or missing credentials
- `403`: User not authorized to perform this operation

---

[API](https://skmtc.dev/project44/apis/project44-rest-api.md) - [All operations](https://skmtc.dev/project44/apis/project44-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/project44/apis/project44-rest-api/revisions/cdf9675e2294?raw)