Bridge
Contact us
API reference · Protection & control

Transaction context

GET Search captured transaction context

GET /transaction/context

Every filter is optional and they combine. The window defaults to the last ninety days when no dates are given. This is the surface that answers a question nobody thought to write a rule for - every transaction from one ASN, or one IP, or one geohash prefix - which is why the circumstances are stored rather than only the conclusions drawn from them at the time.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Query parameters

NameDefault
userReferenceOptional
deviceReferenceOptional
ipAddressOptional
countryOptional
asnOptional
originOptional
geoHashPrefixOptional
fromOptional
toOptional
page[object Object]
size[object Object]

Example

Response: GenericResponseRequestCircumstancePage

curl -X GET "https://api.bridgemoni.com/transaction/context?page=value&size=value" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Transaction context retrieved successfully

GET Read the circumstances under which one transaction was made

GET /transaction/{transactionReference}/context

The record is written before the transaction is screened and in its own database transaction, so a refused transaction still has one - those are the ones whose circumstances matter most. Every value carries an assurance grade: DERIVED means Bridge computed it from something the client cannot control, DECLARED means the client asserted it and nothing corroborated it, and CONTRADICTED means a claim and an independent derivation disagreed. Precise coordinates are not returned here; read the attributes endpoint for those.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
transactionReference

Example

Response: GenericResponseRequestCircumstance

curl -X GET "https://api.bridgemoni.com/transaction/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/context" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Transaction context retrieved successfully

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors