To integrate your company with Tractian's API, you'll need an authentication token. This token enables secure access to available API resources and must be included in all requests using the Authorization header in the format: Bearer {your_token}.
Below are the two types of tokens available and how to request yours.
Token Linked to a User and Company
This token is directly tied to a specific user within your company. All actions performed through the API will be recorded under that user's name in the platform.
Example:
“User John Smith created the asset API Integration Test”
This type of token is ideal for one-off or individual uses, such as:
Data queries for testing or analysis
Bulk registration of assets during historical data migration
Personal scripts for automation or monitoring
Recommended when the integration is handled by a specific team member for limited or internal tasks.
Token Linked to the Company Only
In this case, the token represents the company itself, with no connection to a specific user. All actions are registered in the platform as performed by the company's API.
Example:
“API from Company X added an item to inventory”
This model is better suited for continuous or automated system integrations, including:
Purchasing systems integrated with Tractian inventory
Maintenance software that creates work orders automatically
Internal tools that update asset data regularly
Ideal for technical and operational use in corporate system integrations.
How to Request a Token
To request your access token, contact the Tractian support team. Please include the following details:
Your contact information
The purpose of the API usage (e.g., purchasing system integration, data migration, internal dashboards, etc.)
Once the request is approved, the token will be generated and sent to the email you provided.
Important note: API usage may involve an additional cost. Contact support for pricing details.
How to Use the Token
Once you receive your token, include it in your HTTP requests like this:
Authorization: Bearer your_token_here
You’ll then be ready to securely access the Tractian API and start your integration.