List asset categories

Request#

GET /api/v1/asset-categories

Requires asset-categories:read. The token creator must remain an active administrator of the token’s organization. Category permissions.

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

Query parameters#

page integer Optional

The page of results to return. Starts at 1; defaults to 1.

per_page integer Optional

The maximum number of categories per page. Accepts 1–100; defaults to 25.

Example#

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example IDs with values from your organization.

curl --request GET "https://my.assetcenter.app/api/v1/asset-categories?per_page=25" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK. Illustrative response; IDs and values will differ.

{
  "data": [
    {
      "id": 7,
      "name": "Vehicles",
      "description": null,
      "end_of_life": null,
      "useful_life": null,
      "eol_lookahead_days": "dont_notify",
      "warranty_lookahead_days": "dont_notify",
      "can_delete": true
    }
  ],
  "links": {
    "next": null,
    "prev": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 1
  }
}

Behavior and constraints#

Categories are ordered by numeric ID, oldest first. Follow links.next until null; additional pagination links and metadata are present. Search, sort, and other filters are unsupported. List responses omit custom_fields; get a category to read its field definitions. can_delete is false when any asset uses the category or its fields retain values, including values from assets moved elsewhere.

Errors#

401 means the customer bearer token is missing, expired, revoked, or invalid. 403 means the required permission is missing or the token creator is no longer an active organization administrator. 404 means the category or field is unavailable in this organization. 422 identifies invalid or unsupported input. 429 means a rate limit was reached. Error handling and rate limits.