Skip to main content
GET
/
api
/
decisions
/
{id}
Get decision details
curl --request GET \
  --url https://{instance}.{env}.on-hellgate.cloud/api/decisions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "backend_results": [
    {
      "backend": "<string>",
      "error": "<string>",
      "latency_ms": 123,
      "link_execution_id": "<string>",
      "link_timing": {
        "external": 123,
        "internal": 123,
        "total": 123
      },
      "live": true,
      "missing_fields": [
        "<string>"
      ],
      "raw_response": {},
      "rule_id": "<string>"
    }
  ],
  "context": "checkout",
  "credential_fingerprint": "crd_4ba218...",
  "currency": "<string>",
  "customer_id": "<string>",
  "device_fingerprint": "<string>",
  "device_ip": "<string>",
  "evaluated_at": "2023-11-07T05:31:56Z",
  "events": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "occurred_at": "2023-11-07T05:31:56Z",
      "processed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_backend_error": true,
  "integration": "<string>",
  "interceptor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "masked_credential": "411111 ****** 4242",
  "metadata": {},
  "resolution": {
    "resolved_at": "2023-11-07T05:31:56Z"
  },
  "ruleset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ruleset_version": 123,
  "transaction_reference": "<string>",
  "triggered_rules": [
    {
      "action": "BLOCK",
      "name": "Block USD",
      "rule_id": "r1",
      "type": "condition"
    }
  ]
}

Authorizations

Authorization
string
header
required

HS256-signed JWT bearer token, obtained via the OAuth2 client-credentials grant (see Authentication).

Path Parameters

id
string
required

Decision ID

Response

Decision entry

Persisted decision log entry.

id
string<uuid>
amount
integer | null
backend_results
BackendResult · object[]

One entry per backend rule that was executed.

context
string
Example:

"checkout"

credential_fingerprint
string
Example:

"crd_4ba218..."

credential_type
enum<string> | null

Type of credential supplied in the request

Available options:
pan,
masked_pan,
sepa
currency
string | null
customer_id
string | null
decision
enum<string>
Available options:
ALLOW,
BLOCK,
REVIEW
device_fingerprint
string | null
device_ip
string | null
evaluated_at
string<date-time>
events
object[]

Lifecycle events ingested for this decision, ordered by occurred_at.

has_backend_error
boolean

True if any backend_results entry carries a non-nil error (e.g. "backend_capability_disabled").

integration
string | null

Integration type that originated this decision (e.g. 'interceptor')

interceptor_id
string<uuid> | null

ID of the interceptor that originated this decision

masked_credential
string | null

Display-safe masked representation, e.g. '411111 ****** 4242'

Example:

"411111 ****** 4242"

metadata
object

Merchant-supplied key-value pairs stored with the decision.

resolution
object

Present when the decision was REVIEW and has been resolved by the merchant.

ruleset_id
string<uuid> | null
ruleset_version
integer | null
source
enum<string>
Available options:
RULE_ENGINE,
BACKEND,
COMBINED
transaction_reference
string | null
triggered_rules
TriggeredRule · object[]