Authentication
Every request is authenticated with an API key sent as a bearer token.
Send your key
Put the key in the Authorization header:
Authorization: Bearer gl_test_9f2c…Test and live mode
The mode belongs to the key itself, not to anything you send with a request. A gl_test_ key can only read and write test data, and a gl_live_ key can only read and write live data. A key can never act as another business.
Test and live records are completely separate: the same ownerRef can exist in both, with different accounts and balances.
Authentication errors
| Status | Meaning |
|---|---|
401 | The header is missing, or the key is invalid or revoked. |
403 | The key is valid but the business is suspended or can't make requests. |
{ "message": "Not authenticated - invalid or revoked API key" }