Skip to main content
GET
/
v3
/
transactions
/
{transaction_id}
/
curl
curl -X GET 'https://verification.didit.me/v3/transactions/abcdef12-3456-7890-abcd-ef1234567890/' \
  -H 'x-api-key: YOUR_API_KEY'
{
  "uuid": "abcdef12-3456-4890-abcd-ef1234567890",
  "transaction_number": 4123,
  "txn_id": "your-txn-2026-05-17-001",
  "txn_date": "2026-05-17T08:42:00Z",
  "zone_id": "Europe/Madrid",
  "transaction_type": "finance",
  "action_type": "withdrawal",
  "direction": "OUTBOUND",
  "status": "IN_REVIEW",
  "amount": "1500",
  "currency": "EUR",
  "currency_type": "fiat",
  "amount_in_default_currency": "1620.45",
  "default_currency_code": "USD",
  "preferred_currency_amount": "1620.45",
  "preferred_currency_code": "USD",
  "payment_details": "Withdrawal to crypto wallet",
  "payment_txn_id": null,
  "score": 78,
  "severity": "HIGH",
  "decision_reason_code": "WALLET_HIGH_RISK",
  "decision_reason_label": "Destination wallet flagged as high risk",
  "vendor_data": "user-12345",
  "metadata": {
    "subject": {
      "entity_type": "individual",
      "vendor_data": "user-12345",
      "full_name": "Maria Garcia",
      "address": {},
      "institution_details": {},
      "device_context": {}
    },
    "counterparty": {}
  },
  "props": {
    "order_id": "ord-9988"
  },
  "tags": [],
  "parties": [
    {
      "uuid": "b1111111-2222-4333-8444-555555555555",
      "role": "APPLICANT",
      "entity_type": "individual",
      "kind": "USER",
      "vendor_data": "user-12345",
      "full_name": "Maria Garcia",
      "first_name": null,
      "last_name": null,
      "country_code": null,
      "dob": null,
      "address": {},
      "institution_info": {},
      "device": {},
      "external_party_snapshot": null
    }
  ],
  "payment_methods": [],
  "activities": [],
  "alerts": [
    {
      "uuid": "a7b8c9d0-1234-4abc-9def-567890abcdef",
      "title": "Destination wallet flagged as high risk",
      "description": "Provider risk score exceeded the configured threshold.",
      "severity": "HIGH",
      "status": "OPEN",
      "source": "RULE",
      "metadata": {},
      "created_at": "2026-05-17T08:42:12Z",
      "due_at": null
    }
  ],
  "rule_runs": [],
  "provider_results": [],
  "travel_rule": null,
  "network_snapshot": null,
  "remediation": null,
  "cost_breakdown": null
}

Authorizations

x-api-key
string
header
required

Path Parameters

transaction_id
string<uuid>
required

Didit-stable transaction UUID (the uuid returned from create / list, not your txn_id).

Response

Full transaction detail.

Full monitoring record for one transaction, as returned by GET /v3/transactions/{transaction_id}/ and POST /v3/transactions/.

uuid
string<uuid>

Didit-stable transaction identifier. Use as {transaction_id} for follow-up calls.

transaction_number
integer

Application-scoped sequential transaction number shown in Console (e.g. 4123).

txn_id
string

The transaction_id you supplied at create time (max 128 chars). Unique per application.

txn_date
string<date-time>

When the transaction occurred (from transaction_at; defaults to submission time).

zone_id
string | null

IANA time zone identifier provided at create time.

transaction_type
string

Top-level category as stored: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. Note multi-word values are echoed back in camelCase even when submitted in snake_case.

action_type
string

Sub-type within the category (e.g. deposit, withdrawal, transfer). Defaults to the category when not supplied.

direction
enum<string>

Direction relative to the subject. Stored uppercase regardless of the casing submitted (in/out/inbound/outbound are accepted on input).

Available options:
INBOUND,
OUTBOUND
status
enum<string>

Current monitoring verdict. Transactions are created APPROVED; rules may flip them to IN_REVIEW/DECLINED synchronously.

Available options:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
amount
string

Transaction amount as a decimal string with trailing zeros stripped (e.g. "1500", "0.5", "0.123456789012345678"). Up to 18 decimal places.

currency
string

Currency code of amount (e.g. EUR, USD, BTC).

currency_type
string | null

fiat or crypto, as submitted in currency_kind.

amount_in_default_currency
string | null

Pre-converted amount you supplied, as a decimal string with trailing zeros stripped.

default_currency_code
string | null
preferred_currency_amount
string | null

amount converted to the application's preferred currency, when available.

preferred_currency_code
string | null
payment_details
string | null

Free-text payment reference or memo from the submission.

payment_txn_id
string | null

External payment system reference (e.g. blockchain transaction hash) from payment_reference_id.

score
integer

Risk score accumulated by rules (typically 0–100). Higher = riskier.

severity
enum<string> | null

Categorical risk severity set by rules/providers (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null until something sets it.

Available options:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

Machine-readable reason for the current status.

decision_reason_label
string | null

Human-readable label for decision_reason_code.

vendor_data
string | null

Convenience copy of the applicant's vendor_data.

metadata
object

Snapshot of the subject and counterparty payloads as submitted at create time.

props
object

The custom_properties you supplied at create time. Each key is addressable in rule conditions as custom_values.<key>.

tags
object[]

Tags attached to the transaction (manually or by rules).

parties
object[]

Transaction parties (applicant, counterparty).

payment_methods
object[]

Payment methods linked to the transaction.

activities
object[]

Activity log entries (creation, notes, manual reviews, status changes).

alerts
object[]

Alerts raised by rules and providers.

rule_runs
object[]

Per-rule execution results — which rule fired, with what score impact.

provider_results
object[]

Raw provider payloads (AML screening, blockchain analytics, etc.).

travel_rule
object

Travel Rule compliance check, present when travel_rule_details was submitted.

network_snapshot
object

Graph snapshot of related transactions/parties used by the rules engine, present when submitted.

remediation
object

Remediation session offered to the user when re-verification is required.

cost_breakdown
object

Per-feature credit cost breakdown for this transaction.