Get a mandate signature request

GET /v2/mandate_signature_requests/{id}

Path parameters

id string(uuid) Required

ID of the mandate signature request.

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- id string(uuid) Required
  
  ID of the mandate signature request
- reference string Required
  
  The unique mandate reference.
  
  Format should match the following pattern: ^[A-Za-z0-9+?/\-:().,'\s]{1,35}$.
- scheme string Required
  
  The mandate scheme.
  
  Values are b2b or core.
- debtor_email string Required
  
  The email address of the debtor.
- debtor object
  
  Debtor information filled when the request was signed. This is available when the request is completed.
  
  Hide debtor attributes Show debtor attributes object
  
  name string Required
  
  Debtor's name.
  
  iban string Required
  
  Debtor's IBAN.
  
  address object
  
  Debtor's address.
  
  Hide address attributes Show address attributes object
  
  street string Required
  
  Debtor's street name.
  
  postal_code string Required
  
  Debtor's postal code.
  
  city string Required
  
  Debtor's city.
  
  country string Required
  
  Debtor's country code.
- email_custom_message string
  
  Custom text message included in the email sent to the debtor.
- contract_reference string
  
  The contract reference attached to the mandate. This is optional metadata.
- status string Required
  
  Current status of the mandate signature request.
  
  Values are sent, expired, or completed.
- language string Required
  
  The language used for the email and signature page for the debtor.
  
  Values are french or english. Default value is french.
- is_deleted boolean Required
  
  Whether or not this mandate signature request has been deleted.

GET /v2/mandate_signature_requests/{id}

curl \
 --request GET 'https://api.memo.bank/v2/mandate_signature_requests/45195a6f-daa8-4bc1-9ac4-3979e72bd89d' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "id": "61b05c4f-3f72-4951-8c30-a2a9faaa5184",
  "reference": "ABC123DEF",
  "scheme": "core",
  "debtor_email": "foo@bar.com",
  "debtor": {
    "name": "John Doe",
    "iban": "FR2512739000308553756377J95",
    "address": {
      "street": "1 rue Rivoli",
      "postal_code": "75004",
      "city": "Paris",
      "country": "FR"
    }
  },
  "email_custom_message": "Hi John Doe, here's a collection mandate to sign.",
  "contract_reference": "CUST-1234",
  "status": "sent",
  "language": "french",
  "is_deleted": false
}