Skip to main content
WEBHOOK

Authorizations

Authorization
string
header
required

First-party access token for your own signed-in session, obtained from the /api/enterprise-auth/login endpoint. The REST API returns your own account data to you — it is a first-party consumer surface, not a third-party integration channel. Data from connected bank feeds (open-banking / CDR data) is your own data, returned only to you in your own authenticated session.

Headers

X-AI2Fin-Signature
string
required

t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" with your signing secret>. During the 24 hours after a secret rotation a second v1= (previous secret) is appended. Reject timestamps more than 5 minutes off.

X-AI2Fin-Event
string
required
X-AI2Fin-Delivery
string
required

The delivery id. Automatic retries of a delivery keep the same id, so use it to de-duplicate; a manual redelivery gets a new id.

Body

application/json
event
string
required
Allowed value: "ping"
createdAt
string<date-time>
required
data
object
required

Response

2XX

Acknowledged. Any other status, or no response within 10 seconds, is a failure: the delivery is retried after 30 s, 2 min, 10 min, 1 h and 6 h (6 attempts in all), then marked dead. 8 dead deliveries in a row disable the subscription.