Get a Mandate

curl "https://sandbox.api.prava.space/v1/mandates/mdt_123" \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.get(
    "https://sandbox.api.prava.space/v1/mandates/mdt_123",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/mandates/mdt_123", {
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{
  "id": "mdt_123",
  "status": "active",
  "approvedAmount": "40.00",
  "currency": "USD",
  "spent": "40.00",
  "chargeCount": 1,
  "charges": [
    { "transactionId": "txn_9", "amount": "40.00", "currency": "USD", "status": "completed", "reference": "invoice_2026_07", "createdAt": "2026-07-26T00:00:00Z" }
  ]
}

{
  "error": { "code": "MANDATE_FORBIDDEN", "message": "Caller does not own this mandate" }
}

{
  "error": { "code": "MANDATE_NOT_FOUND", "message": "No such mandate" }
}

GET

mandates

{id}

curl "https://sandbox.api.prava.space/v1/mandates/mdt_123" \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.get(
    "https://sandbox.api.prava.space/v1/mandates/mdt_123",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/mandates/mdt_123", {
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{
  "id": "mdt_123",
  "status": "active",
  "approvedAmount": "40.00",
  "currency": "USD",
  "spent": "40.00",
  "chargeCount": 1,
  "charges": [
    { "transactionId": "txn_9", "amount": "40.00", "currency": "USD", "status": "completed", "reference": "invoice_2026_07", "createdAt": "2026-07-26T00:00:00Z" }
  ]
}

{
  "error": { "code": "MANDATE_FORBIDDEN", "message": "Caller does not own this mandate" }
}

{
  "error": { "code": "MANDATE_NOT_FOUND", "message": "No such mandate" }
}

Retrieve one mandate with its derived balance and full charge history. GET /v1/mandates/{id} · Authenticated with your secret key. Need to create a mandate? Mandate creation is part of the Session APIs — create a mandate with a mandate_setup block on Create Session.

Path parameters

string

required

The mandate id.

Response

Everything in the List Mandates mandate object, plus:

string

Cumulative amount charged.

integer

object[]

Show charge properties

string

string | null

Idempotency reference supplied at charge time.

string

Error responses

Status	Code	Cause
401	`AUTH_REQUIRED`	Missing or invalid credentials
403	`MANDATE_FORBIDDEN`	Caller does not own this mandate
404	`MANDATE_NOT_FOUND`	No such mandate

curl "https://sandbox.api.prava.space/v1/mandates/mdt_123" \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.get(
    "https://sandbox.api.prava.space/v1/mandates/mdt_123",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/mandates/mdt_123", {
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{
  "id": "mdt_123",
  "status": "active",
  "approvedAmount": "40.00",
  "currency": "USD",
  "spent": "40.00",
  "chargeCount": 1,
  "charges": [
    { "transactionId": "txn_9", "amount": "40.00", "currency": "USD", "status": "completed", "reference": "invoice_2026_07", "createdAt": "2026-07-26T00:00:00Z" }
  ]
}

{
  "error": { "code": "MANDATE_FORBIDDEN", "message": "Caller does not own this mandate" }
}

{
  "error": { "code": "MANDATE_NOT_FOUND", "message": "No such mandate" }
}

Server-Side API

Reference

Path parameters

Response

Error responses

​Path parameters

​Response

​Error responses

Path parameters

Response

Error responses