The Bardge Reseller API authenticates using API keys passed as Bearer tokens.How to authenticate#
Include your API key in the Authorization header on every request:Authorization: Bearer <your-api-key>
Your API key is tied to your reseller account. Keep it secret — treat it like a password. Do not expose it in client-side code or public repositories.Finding your API key#
Your API key is available in the Bardge Reseller Dashboard:1.
Log in to the Bardge Reseller Dashboard
2.
Click Settings in the left sidebar
Your active API key is displayed on this page. You can also rotate your key from here.How keys work#
API keys are encrypted tokens. When you send a request, the API:1.
Extracts the Bearer token from the Authorization header
2.
Decrypts and validates the key against your reseller account
3.
Checks that your account is active and enabled
All of this happens transparently — you simply pass the key as issued.Error responses#
If your API key is missing or invalid, the API returns:{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API key provided",
"request_id": "req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
}
}
If your reseller account has been disabled:{
"error": {
"type": "permission_error",
"code": "account_disabled",
"message": "Reseller account is not enabled",
"request_id": "req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
}
}
Key rotation#
You can rotate your API key at any time from the Bardge Reseller Dashboard:1.
Log in to the Bardge Reseller Dashboard
2.
Click Settings in the left sidebar
4.
Click Reset secret API keys
Your old key is invalidated immediately upon rotation. Update all integrations with the new key before rotating to avoid downtime. Modified at 2026-05-07 11:57:55