Get Asset List
This API returns the paginated list of tracking asset identifiers (Truck plate numbers, Trailer numbers, etc.,) for a given carrier.
Rate Limit
5 requests per minute
Format Supported
JSON
Authenticated Resource
API Key
For more information on Authentication, click here.
List of GPS Providers Supported in Asset List API
- BigRoad
- BlueTree-VehicleName
- Rand McNally
- Fleetmatics
- Geotab
- GeotabGetFeed
- GeotabReseller
- IsaacInstruments
- JjKeller
- KeepTruckin
- LinxupV2
- Verizon
- TxtESolutions
- Peoplenet
- NexTraqMobileName
curl --request GET \
--url https://api.fourkites.com/carriers/asset-list?carrierId=SOME_CARRIER_IDENTIFIER \
--header 'apikey: REPLACE_KEY_VALUE'
curl --request GET \
--url https://api-staging.fourkites.com/carriers/asset-list?carrierId=SOME_CARRIER_IDENTIFIER \
--header 'apikey: REPLACE_KEY_VALUE'
Request Attributes
Name | Param Type | Format | Default | Example | Description |
|---|---|---|---|---|---|
page | Query | Integer | 1 | 1 | Returns results associated with the given page number. |
perPage | Query | Integer | 10 | 10 | The maximum results to be returned by the List API. The minimum value is 1 and the maximum value is 100. |
carrierId | Query | String | Mandatory | 2839853 | Denotes the unique carrier identifier which is essentially the scac that is specified in the network of the customer and the carrier in the FourKites® platform. |
Response Attributes
Name | Format | Description |
|---|---|---|
data | NA | The root element of the response. |
page | Integer | Returns results associated with the given page number. |
perPage | Integer | The maximum results to be returned by the List API. The minimum value is 1 and the maximum value is 100. |
assetList | Array of Strings | Contains the list of truck numbers that are tracked by the carrier specified in the request. |
totalCount | Integer | The total count of results present across all pages. |
requestId | String | Each API request has an associated request identifier. You can find this value in the response body, under requestId. If you need to contact us about a specific request, providing the request identifier will ensure quick resolution. |