AssetCenter
Getting started
Connect your own tools to AssetCenter with an organization-scoped API token.
Last updated
The AssetCenter customer API lets you read and manage assets, people, locations, and subscriptions, including their assignments, timeline history, to-dos, and lifecycle actions. You can also edit timeline entries, create and manage threaded comments, search paginated lookup choices, search across records, read GPS positions, and pull dashboard reports. Organization actions also support settings, logos, exports, and deletion. Use it to connect reporting tools, synchronize inventory, or automate routine updates.
Before you begin
You need an AssetCenter account and an active account administrator in the organization you want to connect. Create an account from AssetCenter if you do not have one. The user manual explains the records and workflows you will work with.
Open Settings → API Access in the product. Give the token a recognizable name, choose Read Only, Full Access, or Custom permissions, and select an expiry of 30 days, 90 days, or one year. Copy the token immediately: it is shown only once. Store it in your integration’s secret storage.
Start with Read Only for the first requests in the quick start. Create a token with the necessary write or workflow permissions when you are ready to automate changes. Existing tokens retain their original permissions.
Base URL
https://my.assetcenter.app/api/v1
Customer endpoint paths in this guide start with /api/v1. Send requests to the product host shown above. This website’s /api pages contain the documentation.
The guide covers the versioned customer integration API. Customer tokens cannot use the unversioned routes used internally by the mobile app, including its login, dashboard, and assistant routes; use the versioned dashboard reports instead. Create the integration token in Settings instead of calling a login endpoint.
Choose a resource
| Resource | Use it for |
|---|---|
| Billing | The organization’s AssetCenter plan, usage, and invoices, with billing:read. |
| Organizations | The token's organization settings, login security, logos, exports, and deletion. Organization creation and switching are unavailable to customer tokens. |
| Subscription categories | Category settings, contract-notification windows, and custom-field definitions. |
| Asset categories | Category settings, lifecycle defaults, and custom-field definitions. |
| Assets | Equipment details, custody, storage, condition, acquisitions, warranties, and decommissioning. |
| Lookups | Searchable IDs and names for assets, manufacturers, active people, locations, spaces, and organization users. |
| People | Inventory people, active status, assignments, and notes. These are distinct from login users. |
| Locations | Sites, spaces, assigned equipment, people, and subscriptions. |
| Subscriptions | Licenses, billing, contracts, assignments, and service status. |
Make your first request
Continue to the quick start to list records and read a timeline. Then review authentication and permissions, pagination, and idempotency before building a recurring integration.