Sign in
Direct Debit

Find mandate by ID

Return information about the mandate. The Authorisation token needs to be specified in the 'Authorization' header as 'Authorization: Bearer YOUR_API_KEY_HERE'

get/v1/directdebit/mandates/{mandateId}

Path parameters

mandateIdstring required

Response

OK

mandate_idstring

mandate id

provider_idstring

provider id

referencestring

service reference

return_urlstring

service return url

bank_statement_referencestring

This value comes from GoCardless when a mandate has been created.

created_datestring

mandate created date

descriptionstring

description

payment_providerstring

payment_provider

Example response

{
  "mandate_id": "jhjcvaiqlediuhh23d89hd3",
  "provider_id": "jhjcvaiqlediuhh23d89hd3",
  "reference": "jhjcvaiqlediuhh23d89hd3",
  "return_url": "https://service-name.gov.uk/transactions/12345",
  "_links": {
    "self": {
      "href": "https://an.example.link/from/payment/platform",
      "method": "GET"
    },
    "next_url": {
      "href": "https://an.example.link/from/payment/platform",
      "method": "GET"
    },
    "next_url_post": {
      "type": "application/x-www-form-urlencoded",
      "href": "https://an.example.link/from/payment/platform",
      "method": "POST"
    },
    "payments": {
      "href": "https://an.example.link/from/payment/platform",
      "method": "GET"
    }
  }
}

Changes