Authentication (JWT)

Authenticated endpoints require a JWT bearer token.

Required Headers

• Authorization: Bearer <JWT>

• Content-Type: application/json

Obtaining a Token

1

Contact the deployer/service provider

Apply for integration by contacting the deployer or service provider.

2

Provide company information and integration identifier

Supply the requested company information and an integration identifier.

3

Receive a dedicated JWT token

The service provider will issue a dedicated JWT token for your integration.

Common Errors

HTTP	message	Meaning	Fix
401	missing api key	Missing Authorization header	Add Authorization: Bearer <token>
401	Token format invalid or signature error	Token is malformed/tampered	Verify the full token string
401	Token has expired	Token expired	Request a new token
401	Account is disabled	Account disabled	Contact the service provider

Error envelope example:

{
  "code": 401,
  "message": "Token format invalid or signature error"
}