Skip to main content
POST
Handles `POST /v1/transactions`.

Authorizations

Authorization
string
header
required

A tenant API key. Acts for exactly one tenant and cannot conclude a case, because a conclusion records a person.

Body

application/json

Transaction ingestion request body.

amount
string
required

Decimal amount at the asset's scale.

asset
object
required

Asset transferred.

direction
enum<string>
required

Direction relative to the customer.

Available options:
DEPOSIT,
WITHDRAWAL
from_addresses
string[]
required

Sending addresses.

network
required

Network the transfer settled on.

Available options:
BITCOIN
occurred_at
string
required

RFC 3339 time the transfer occurred.

source
object
required

Submitting system and reference.

subject_id
string
required

Tenant's customer the transaction belongs to.

to_addresses
string[]
required

Receiving addresses.

customer_wallet
string | null

The customer's own wallet.

destination_wallet
string | null

Wallet the value went to.

fiat_value
null | object

Fiat-equivalent value.

metadata
object

Integration metadata, kept out of decision logic.

originating_wallet
string | null

Wallet the value came from.

transaction_hash
string | null

On-chain transaction hash.

Response

A replayed Idempotency-Key; the original record

Transaction record response body.

decision
enum<string>
required

Decision outcome. Sentinel recommends; it never enforces.

Available options:
ALLOW,
WARN,
BLOCK,
HOLD,
REVIEW_REQUIRED,
FLAG,
BLOCK_RECOMMENDED,
SUSPEND,
END_STREAM
decision_id
string
required

Decision record identifier.

evidence
object[]
required

References to retained evidence.

reasons
object[]
required

Explanation reasons.

received_at
string
required

RFC 3339 time the event was accepted.

review_status
enum<string>
required

Review lifecycle state.

Available options:
PENDING,
APPROVED,
OVERTURNED,
NOT_REQUIRED
risk_level
enum<string>
required

Explainable risk level.

Available options:
LOW,
MEDIUM,
HIGH,
CRITICAL
transaction_id
string
required

Gorgon's transaction identifier.

case_id
string | null

Review case opened for the decision, when one was needed.