Skip to main content
Report a batch
Same headers, responses, and failure modes as Report an order event.

Authorizations

X-Bilt-Key-Id
string
header
required

Order reports are signed, not sent with a token. Send the key ID Bilt issued when you registered your Ed25519 public key in X-Bilt-Key-Id, and sign each request with the Standard Webhooks v1a scheme in the webhook-* headers. See Sign your requests.

Headers

webhook-id
string
required

Unique ID for this request, and the deduplication key. Send the same value with the same body on every retry. The same value with a different body is REJECTED with IDEMPOTENCY_KEY_REUSED.

Required string length: 1 - 1024
webhook-timestamp
string
required

When you signed the request, in integer Unix seconds. Bilt rejects a timestamp more than 300 seconds from when it received the request (stale_timestamp).

Maximum string length: 1024
Pattern: ^\d+$
webhook-signature
string
required

v1a, followed by the base64 Ed25519 signature of {webhook-id}.{webhook-timestamp}.{raw body}. You can send several space-separated entries during key rotation. Any one valid v1a entry passes, and other schemes are ignored.

Required string length: 1 - 1024

Body

application/json

Between 1 and 100 events, checked in array order.

events
object[]
required
Required array length: 1 - 100 elements

Response

Bilt stored the request and will check it within seconds. The outcome (ACCEPTED, HELD, or REJECTED, with a reason) is not in the response. No body.