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 to apply for integration.
2. Provide company information and an integration identifier.
3. Receive a dedicated JWT token.

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"
}