Skip to main content
Once your Specter instance is provisioned (see Plans & Access), you reach the API at your dedicated instance URL, where {instance} is your unique instance slug and eu1 is the current environment:

​
Authentication

Every API request must carry an OAuth2 access token — a signed JSON Web Token (JWT) — in the Authorization header:
You request the token with the client-credentials grant — see Authentication for the token endpoint, audiences, and scopes. Your instance’s audience is its instance name (for example, my-lovely-specter-42).

​
Scopes

Each endpoint requires a specific scope. Request only the scopes a given integration needs through the scope parameter when you request a token.
Runtime scopes (decisions:*, events:*, interceptors:execute) belong to your payment integration. The admin:* scopes are for configuration and operations, and should be issued to operator or back-office clients only.

​
Next steps

API

Send your first decision request.