AssetCenter
/api/v1/people
List people
List people in the organization attached to your API token.
Last updated
Request
GET /api/v1/people
Requires people: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/people?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,
"first_name": "Alex",
"last_name": "Morgan",
"email": "[email protected]",
"title": null,
"department": "Operations",
"phone_number": null,
"is_external": false,
"organization": null,
"status": "active",
"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.