usage.limit_reached
Fires when the organization reaches its monthly document quota or an eID signature quota, at most once per quota and billing period. Signatures beyond the quota are billed from the balance; documents beyond it are refused until the period ends or the plan changes. GET /api/v1/limits returns the current usage.
webhook-id*stringThe event id. It stays the same across retries and replays, so deduplicate on it.
webhook-timestamp*stringWhen sajn sent this attempt, in Unix seconds. Reject a timestamp older than your tolerance, such as five minutes.
webhook-signature?stringOne or more space-separated signatures, v1,<base64 HMAC-SHA256>, over <webhook-id>.<webhook-timestamp>.<raw request body>. The key is the base64 decoding of the secret after whsec_. Accept the request when any signature matches; for 24 hours after a secret rotation, there is one per secret. Any Standard Webhooks library verifies it. Webhooks created without a secret don't send this header.
Sajn-Version*"2026-10"The endpoint's API version, the same value as apiVersion in the body.
"2026-10"application/json- body
id*stringEvent ID, also in webhook-id. It's the same on every retry, replay and endpoint that receives the event, so deduplicate on it. To read the event again, pass it to GET /api/v1/events/{id}.
type*"usage.limit_reached""usage.limit_reached"createdAt*stringWhen the event happened. It doesn't change across retries and replays.
date-timeapiVersion*"2026-10"The endpoint's API version, which sets the shape of data.
"2026-10"workspaceId*stringorganizationId*stringThe organization the event happened in.
environment*stringSANDBOX for an event in a sandbox organization.
"PRODUCTION""SANDBOX"actor*|nulldata*Return any 2xx status code within 30 seconds to acknowledge the delivery. sajn retries any other status code, a redirect, a timeout and a network error with backoff for about three days, 12 attempts in all. A 410 Gone stops the retries and pauses the webhook.
{ "id": "cm4k2x9p10014abcd1234efgh", "type": "usage.limit_reached", "createdAt": "2026-09-28T14:03:00.000Z", "apiVersion": "2026-10", "workspaceId": "cm4k2x9p10001abcd1234efgh", "organizationId": "cm4k2x9p10000abcd1234efgh", "environment": "PRODUCTION", "actor": { "type": "USER", "id": "cm4k2x9p10002abcd1234efgh" }, "data": { "object": { "organizationId": "cm4k2x9p10000abcd1234efgh", "resource": "SIGNATURES", "scheme": "SE_BANKID", "quota": 100, "used": 100, "periodStart": "2026-10-01T00:00:00.000Z" } }}{ "webhook-id": "cm4k2x9p10014abcd1234efgh", "webhook-timestamp": "1759304580", "webhook-signature": "v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=", "Sajn-Version": "2026-10"}Was this page helpful?