---
title: "Get list of assets for a given carrier"
method: GET
path: "/api/v4/tl/assets"
tags: ["TL: Tracking"]
---

# Get list of assets for a given carrier

`GET /api/v4/tl/assets`

## Request

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

This endpoint will return all assets for the carrier that are known to project44. <h4><b>Required Fields</b></h4>
<ul><li> capacityProviderIdentifierValue </li><li> capacityProviderIdentifierType </li></ul>

## Query parameters

- `capacityProviderIdentifierType` 'SCAC' | 'DOT_NUMBER' | 'MC_NUMBER' | 'P44_EU' | 'SYSTEM' | 'P44_GLOBAL' | 'VAT'
- `capacityProviderIdentifierValue` string
- `page` integer
- `size` integer

## Response `200`

OK

- TruckloadAssetCollection: List of matching asset identifiers
  - `infoMessages` Message[]: List of messages associated with the results
    - `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.
  - `paginationInfo` PaginationInfo: Pagination information about a collection of resources.
    - `pageNumber` integer: Matching page number given the supplied PaginationParameters.
    - `pageSize` integer: Page size matching the PaginationParameters.
    - `total` integer: Total number of resource items matching the supplied criteria.
  - `results` TruckloadEquipmentIdentifier[]: List of resources contained on this page.
    - `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.

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