AssetCenter
Sign in Get started - it's free!

↑ ↓ to navigate · ↵ to open See all results
GET /api/v1/organizations/{organization}/exports/{exportResource}

Download an organization export

Download an authenticated Excel export of assets, subscriptions, people, or locations.

Last updated

Request

GET /api/v1/organizations/{organization}/exports/{exportResource}

Requires organizations:export and the selected resource's :read permission. For an assets export, both organizations:export and assets:read are required. See token permissions.

Send Authorization: Bearer YOUR_API_TOKEN. You may send Accept: application/json to receive JSON errors; a successful response is an Excel file. No request body is supported. GET requests do not require an idempotency key.

Path parameters

Parameter Type Usage
organization integer Required. Must match the organization bound to the token.
exportResource string Required. assets, subscriptions, people, or locations.

Query parameters

This endpoint does not use query parameters.

Example

cURL / Bash 
curl --fail --output asset_center_assets.xlsx \
  "https://my.assetcenter.app/api/v1/organizations/42/exports/assets" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response

200 OK downloads the selected resource's Excel workbook directly. It contains the same organization export columns and rows available from the app, scoped to the token's organization. Data is generated at download time.

Related assignment names, loan dates, and counts are left blank unless the token also has the related resource's Read permission. For example, an assets export needs people:read to include its assigned person and person loan due date.

The filename is asset_center_{resource}.xlsx; the content type is application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. The response uses Cache-Control: private, no-store. There is no JSON data object or signed download URL to follow. Every download request requires the bearer token and checks its current permissions.

Behavior and constraints

Downloads have an additional limit of 10 requests per minute per token, alongside the standard 60-per-token and 300-per-organization limits. A Read Only token does not include organizations:export; choose Custom with Export and the needed resource Read permissions, or Full Access.

Errors

401 means invalid authentication; 403 means a required permission or administrator access is missing. A different organization's ID or unsupported resource returns 404. Unsupported input returns 422; exceeding any applicable rate limit returns 429. See error handling and rate limits.