Authentication
Create a key in the dashboard and send it as a Bearer token.
Every request sends your key in the Authorization header:
Authorization: Bearer gm_live_...This header is the only place the API reads the key. A key in a query string or a cookie does not authenticate.
Create a key
- Sign in to GetMattered.
- Open Developers in the dashboard.
- Choose Create key and give it a name, like
Production. - Copy the key. We show it once.
We store only a hash of the key, so we cannot show it to you again. We email you each time a key is created on your account.
Sign in and your keys and token balance show here.
Sign in to get a keyKeys
- A key starts with
gm_live_. - A key acts as you. Its calls spend your API tokens, and its applications go out from your account.
- A key sends applications only if you ticked Can send applications when you made it. See Key scopes.
- An account can have up to 5 active keys. Revoke one to create another.
- Each key has its own per-minute rate limit. See Rate limits.
- The dashboard and your usage report list each key by its name and its first characters, like
gm_live_AbCd.
Keep keys on your server. Never put a key in browser code, a mobile app or a public repository.
Revoke a key
Open Developers and choose Revoke next to the key. The key stops working at once, on its next call. A revoked key never comes back. Create a new one to replace it.
Enterprise volume
Need more than self-serve, such as high volume, applications for your own candidates or custom terms? Send the enterprise form in the same Developers section. We reply by email.
When authentication fails
A missing, malformed, unknown or revoked key gets 401 with the code UNAUTHORIZED:
{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Missing API key. Send it as `Authorization: Bearer gm_live_...`.",
"context": { "errorType": "authentication", "failureReason": "missing_token" }
},
"meta": { "timestamp": "2026-11-18T12:00:00.000Z", "version": "v1" }
}A refused call runs no work and spends no tokens.