Drazill API Documentation

Event schema version 2026-05-08. Delivered as the type field of the webhook envelope, signed with Drazill-Webhook-Signature.

Payload fields

The data object carries these fields. Money and quantity values are delivered as decimal strings. Fields beyond the structural IDs are optional because a producer legitimately omits them on some transitions.

Field	Type	Required
`amount`	number or string · nullable	No
`market_id`	string (uuid) · nullable	No
`reward_id`	string (uuid) · nullable	No
`reward_type`	string · nullable	No
`status`	string · nullable	No

Example delivery

The full request body — the envelope wrapping this event’s data:

1 {
2   "id": "evt_example000000000000000001",
3   "type": "reward.earned",
4   "version": "2026-05-08",
5   "api_version": "v1",
6   "livemode": true,
7   "created_at": "2026-01-15T12:00:00Z",
8   "data": {
9     "amount": "5.00",
10     "market_id": "018f7a80-0000-7000-8000-000000000002",
11     "reward_id": "018f7a80-0000-7000-8000-000000000007",
12     "reward_type": "MARKET_CREATOR",
13     "status": "EARNED"
14   },
15   "request_id": null,
16   "correlation_id": null
17 }

Verify the signature before you act on a webhook, and treat it as a notification: re-read authoritative state from the REST API before moving money. See Signing & verification.