AssetCenter
/api/v1/assets
List assets
List assets in the organization attached to your API token.
Last updated
Request
GET /api/v1/assets
Requires assets:read. See token permissions. Every listed permission is required for this endpoint.
Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.
Query parameters
| Field | Type | Usage |
|---|---|---|
page |
integer | Optional. Starts at 1; default 1. |
per_page |
integer | Optional. 1–100; default 25. |
Example
Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example record and option IDs with values from your organization.
curl --request GET "https://my.assetcenter.app/api/v1/assets?per_page=25" \
--header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
--header "Accept: application/json"
Response
200 OK. Illustrative record and the common pagination fields; inventory responses include additional pagination links and metadata.
{
"data": [
{
"id": 123,
"asset_tag": "LAP-042",
"manufacturer": "Lenovo",
"model": "Field laptop",
"model_number": null,
"serial_number": null,
"manufacture_date": null,
"parent_id": null,
"parent_cost_rollup": false,
"status": "available",
"category_id": 7,
"person_id": null,
"location_id": null,
"sublocation_id": null,
"is_in_storage": false,
"person_loan_due": null,
"location_loan_due": null,
"condition_id": null,
"decommission_event_type_id": null,
"created_at": "2026-09-07T16:00:00.000000Z",
"updated_at": "2026-09-07T16:00:00.000000Z"
}
],
"links": {
"next": null,
"prev": null
},
"meta": {
"current_page": 1,
"last_page": 1,
"per_page": 25,
"total": 1
}
}
Behavior and constraints
Results are ordered by numeric ID, newest first. Follow links.next until it is null. tenant_id and account_id are prohibited. This endpoint does not provide a documented search, status, sort, or updated-since filter.
Errors
401 means the token is missing, expired, revoked, or not a customer API token. 403 means a required permission or administrator access is missing. 422 identifies invalid or unsupported input; inspect the errors object when present. 429 means a rate limit was reached. See error handling and rate limits.