Record a data-subject request

POST/v1/data_requests

Key scope: write · Success: 201

Records a person's request to see (export) or erase (delete) what is held about them, for one of your customers. SET's operator answers it. The answer's whatSetHolds says what SET keeps and what it cannot erase, so you can tell the person. Event data_request.received.

Headers

Idempotency-Key string: Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

customer stringrequired: One of your customers (cus_…).
kind "export" | "delete"required: What the person asks for.

Notes

The request is recorded, not carried out by this call. See Data-subject requests for what SET keeps, what its provider keeps, and how long.

Errors

400 body_invalid
400 kind_invalid
404 customer_unknown
401 api_key_required
401 api_key_invalid
401 api_key_wrong_mode
403 scope_missing
429 rate_limited

All codes: Errors.

Request

curl -X POST "https://wallet.simpleeasytransactions.com/v1/data_requests" \
  -H "Authorization: Bearer $SET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "customer": "cus_4f0c6e2a9b1d4c7e8f3a5b6c7d8e9f01", "kind": "export" }'

Body

{ "customer": "cus_4f0c6e2a9b1d4c7e8f3a5b6c7d8e9f01", "kind": "export" }

Response 201

{ "id": "dsr_…", "object": "data_request", "customer": "cus_4f0c6e2a9b1d4c7e8f3a5b6c7d8e9f01", "kind": "export", "state": "received", "livemode": true, "createdAt": "2026-11-08T15:04:05.000Z", "updatedAt": "2026-11-08T15:04:05.000Z",
  "whatSetHolds": "SET holds this customer's ids, states, amounts and dates for each payment, which payment and tax records require it to keep, and any metadata you set. Identity details (names, documents, bank details) are held by … under its own retention; SET does not store them." }