API Authentication

​

Overview

Asset’s API uses OAuth 2.0 for authentication. All API requests require a valid access token, included in the Authorization header.

​

Getting an Access Token

1. Set Up Your Tenant Account
   • A Tenant Account is required to authenticate with Asset’s API. If you don’t have one, reach out via our Contact form.
   • Once set up, you can manage OAuth credentials in the Asset Dashboard.
2. Obtain Client Credentials
   • Register an application in the Asset Dashboard to receive a client_id and client_secret.
   • Separate credentials exist for Production and Sandbox environments.
3. Request a Token

Use your client credentials to request an access token:

curl --request POST \
  --url https://api.sandbox.getasset.com/v0/auth/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET'

A successful response returns:

{  
  "access_token": "your-access-token",  
  "token_type": "Bearer",
}

​

Authenticating API Requests

Include the access token in the Authorization header:

curl --request GET \
  --url "https://api.sandbox.getasset.com/v0/business?page_size=100" \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Access tokens expire after a set time and must be renewed using the same OAuth flow. Manage credentials in the Asset Dashboard.