Get an asset

Request#

GET /api/v1/assets/{record}

Requires assets:read. See token permissions. Every listed permission is required for this endpoint.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

record is the numeric asset ID in your token’s organization.

Query parameters#

No query parameters are required.

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/123" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK. Example response; IDs, values, and timestamps will differ in your organization.

{
  "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"
  }
}

Behavior and constraints#

The object contains the public record fields shown above. Related records, custom-field values, files, and full history are not embedded. Use the timeline endpoint for history.

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. 404 means the record or child record is unavailable in this organization. 429 means a rate limit was reached. See error handling and rate limits.