Skip to Content
Developers
Redemptions

Report redemptions

POST
/redemptions

Up to 100 orders that used a Pro Deal code. A redemption is unique on (code, orderId): sending it again with a newer updatedAt updates it, and an equal or older one comes back as duplicate, so retries are safe. An associate's next code opens once their current code is reported.

Authorization

integrationKey
headerAuthorizationBearer <token>

A brand integration key, created by an Owner or Admin in Brand Settings › Integrations and shown once. endvr_ik_test_… keys write test data that is never billed; endvr_ik_live_… keys are live.

Request Body

application/json
  1. body
redemptions*array<>
Items1 <= items <= 100

Response Body

One result per item, in request order.

application/json
  1. response
results*array<>
Example Request
curl -X POST 'https://api.endvr.io/v1/redemptions' \  -H 'Content-Type: application/json' \  -d '{  "redemptions": [    {      "code": "PRO-7KQ2-XM4D",      "orderId": "10042",      "orderAmount": "129.90",      "currency": "USD",      "processedAt": "2026-11-17T14:03:00Z",      "status": "paid",      "updatedAt": "2026-11-17T14:03:00Z"    }  ]}'
Example Response
{  "results": [    {      "index": 0,      "result": "accepted"    },    {      "index": 1,      "result": "rejected",      "reason": "unknown_code"    }  ]}