SpareSpare Docs
GuidesAPI Reference
API Reference

Mandates

Schedule, approve, and list transactions for recurring payment mandates.

POST
/mandate/schedule
Authorization
Header

ES256 request signature. Required on signed-write endpoints, see [request signing](/docs/quickstart/request-signing).

Regulatory jurisdiction the request routes to (e.g. `UAE`, `KSA`, `MAIN`). Match it to the market you're integrating.

Body
*object

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/mandate/schedule" \  -H "x-signature: string" \  -H "x-tenant: UAE" \  -H "Content-Type: application/json" \  -d '{    "executionDate": "2025-01-01T00:00:00Z",    "mandateId": "2025-01-01T00:00:00Z"  }'
{  "data": {    "approvedAmount": 0,    "approvedAt": "string",    "creditorAccount": {      "accountHolderName": "string",      "businessName": "string",      "givenName": "string",      "id": "string",      "identification": "string",      "lastName": "string",      "name": "string",      "schemeName": "IBAN"    },    "executionDate": "2025-01-01T00:00:00Z",    "id": "string",    "isApproved": true,    "isVariable": true,    "mandateId": "2025-01-01T00:00:00Z",    "maxAmount": 0,    "status": "string"  },  "error": "string",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  }}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "not_found",  "details": {},  "message": "string"}
PATCH
/mandate/approve
Authorization
Header

ES256 request signature. Required on signed-write endpoints, see [request signing](/docs/quickstart/request-signing).

Regulatory jurisdiction the request routes to (e.g. `UAE`, `KSA`, `MAIN`). Match it to the market you're integrating.

Body
*object

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/mandate/approve" \  -H "x-signature: string" \  -H "x-tenant: UAE" \  -H "Content-Type: application/json" \  -d '{    "mandateId": "2025-01-01T00:00:00Z",    "transactionId": "string"  }'
{  "data": {    "approvedAmount": 0,    "approvedAt": "string",    "creditorAccount": {      "accountHolderName": "string",      "businessName": "string",      "givenName": "string",      "id": "string",      "identification": "string",      "lastName": "string",      "name": "string",      "schemeName": "IBAN"    },    "executionDate": "2025-01-01T00:00:00Z",    "id": "string",    "isApproved": true,    "isVariable": true,    "mandateId": "2025-01-01T00:00:00Z",    "maxAmount": 0,    "status": "string"  },  "error": "string",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  }}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "not_found",  "details": {},  "message": "string"}
GET
/mandate/{mandateId}/transactions
Authorization
Path

UUID of the mandate.

Header

Regulatory jurisdiction the request routes to (e.g. `UAE`, `KSA`, `MAIN`). Match it to the market you're integrating.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/mandate/string/transactions" \  -H "x-tenant: UAE"
{  "data": [    {      "approvedAmount": 0,      "approvedAt": "string",      "creditorAccount": {        "accountHolderName": "string",        "businessName": "string",        "givenName": "string",        "id": "string",        "identification": "string",        "lastName": "string",        "name": "string",        "schemeName": "IBAN"      },      "executionDate": "2025-01-01T00:00:00Z",      "id": "string",      "isApproved": true,      "isVariable": true,      "mandateId": "2025-01-01T00:00:00Z",      "maxAmount": 0,      "status": "string"    }  ],  "error": "string",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  }}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "not_found",  "details": {},  "message": "string"}
PreviousPayment Purpose CodesList valid payment purpose codes for your region.NextWebhooksManage webhook subscriptions and browse the event catalog.