RevKeenDocs
StatusSupport
API Reference
Direct Debit

Look up a pending signed mandate request

Public lookup of a pending signed mandate request by its emailed token. Rate-limited; returns 404 for unknown, consumed, cancelled, or expired tokens.

GET/dd/mandate-requests/{token}

Public lookup of a pending signed mandate request by its emailed token. Rate-limited; returns 404 for unknown, consumed, cancelled, or expired tokens.

Related endpoints

  • POST /dd/validate — Validate a UK bank account for Direct Debit
  • POST /dd/preview — Preview the Direct Debit collection date chain

Common errors

  • 404 resource_missing — the referenced resource does not exist or is not visible to your key.
  • 429 rate_limit_error — code rate_limit_exceeded. Back off using the Retry-After header (whole seconds); X-RateLimit-Reset is a UNIX timestamp in seconds.

Path Parameters

token*string

Signed mandate-request token from the emailed link

Response Body

application/json

application/json

application/json

Stuck on an error response? Ask the RevKeen assistant to explain it.
curl -X GET "https://api.revkeen.com/v2/dd/mandate-requests/example"

Synthetic documentation data, validated against the response schema; not a live API result.

{  "data": {    "id": "2c3d4e5f-6a7b-4c98-8da9-1e2f3a4b5c97",    "merchant_id": "8f14e45f-ceea-4e7a-9b4b-7c3f1a2d5e60",    "merchant_slug": "example-studio",    "customer_id": "c2a1e7d4-5b3f-4a8e-9d21-6f0b3e4c7a11",    "invoice_id": null,    "expires_at": "2026-04-09T10:05:00.000Z",    "status": "pending_signature",    "merchant": {      "id": "8f14e45f-ceea-4e7a-9b4b-7c3f1a2d5e60",      "slug": "example-studio",      "name": "Example Studio"    },    "customer": {      "id": "c2a1e7d4-5b3f-4a8e-9d21-6f0b3e4c7a11",      "name": "Ada Lovelace",      "first_name": "Ada",      "last_name": "Lovelace",      "email": "ada.lovelace@example.com",      "phone": "+44 20 7946 0958"    },    "invoice": null  }}

Put this endpoint to work

Operate Direct Debit