Skip to Content

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

  1. Sign in to GetMattered.
  2. Open Developers in the dashboard.
  3. Choose Create key and give it a name, like Production.
  4. 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 key

Keys

  • 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.

On this page