Skip to main content
GET
Get the card authorization endpoint

Authorizations

Authorization
string
header
required

API token authentication using format <api token id>:<api client secret>

Response

The enrolled card authorization endpoint.

The endpoint Grid calls to ask your platform for a real-time decision on each card authorization that Grid's own checks approve.

url
string<uri>
required

HTTPS URL that receives CARD_AUTHORIZATION.REQUEST requests.

Example:

"https://api.mycompany.com/grid/card-authorizations"

timeoutBehavior
enum<string>
required

What Grid answers for a card authorization when your authorization endpoint does not return a valid decision in time.

A non-200 status, a body that does not match CardAuthorizationDecision, a network error, and a timeout all count as no valid decision.

Available options:
DECLINE,
APPROVE
Example:

"DECLINE"

responseTimeoutMs
integer<int32>
required
read-only

How long Grid waits for your endpoint's decision, in milliseconds, before applying timeoutBehavior. Grid sets this value.

Example:

1500

createdAt
string<date-time>
required

When an endpoint was first enrolled.

Example:

"2026-10-20T15:04:05Z"

updatedAt
string<date-time>
required

When the endpoint was last enrolled or replaced.

Example:

"2026-10-20T15:04:05Z"