AssetCenter
/api/v1/asset-categories/options
Get asset category options
Read supported notification windows, custom-field types, and defaults.
Last updated
Request
GET /api/v1/asset-categories/options
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
This endpoint does not use query parameters.
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/options" \
--header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
--header "Accept: application/json"
Response
200 OK. Illustrative response; IDs and values will differ.
{
"data": {
"notification_options": [
{
"value": "dont_notify",
"label": "Don't Notify"
},
{
"value": "expired_only",
"label": "Only Expired"
},
{
"value": "30_days",
"label": "This Month"
},
{
"value": "90_days",
"label": "This Quarter"
},
{
"value": "this_year",
"label": "This Year"
},
{
"value": "this_next_year",
"label": "This Year & Next Year"
},
{
"value": "12_months",
"label": "12 Months"
},
{
"value": "24_months",
"label": "24 Months"
}
],
"field_types": [
{
"value": "text",
"label": "Text"
},
{
"value": "number",
"label": "Number"
},
{
"value": "date",
"label": "Date"
},
{
"value": "boolean",
"label": "Checkbox"
},
{
"value": "yesno",
"label": "Yes / No / N/A"
},
{
"value": "phone",
"label": "Phone Number"
}
],
"defaults": {
"eol_lookahead_days": "dont_notify",
"warranty_lookahead_days": "dont_notify",
"is_required": false
}
}
}
Behavior and constraints
This endpoint returns a fixed options object without pagination. Use each value in request bodies. The 30_days and 90_days values mean rolling 30-day and 90-day lookahead windows; this_year ends December 31 of the current year and this_next_year ends December 31 of the following year. 12_months and 24_months are rolling month windows. expired_only includes already expired items; dont_notify disables the notification.
New custom fields support the six returned types. Existing editor fields can retain their type when edited, but new editor fields cannot be created. Checkbox (boolean) fields are always optional.
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.