NOnomba
Direct Debits

Get Mandate by ID

Changed on

Fetches full details of a specific direct debit mandate using its mandateId.

get/v1/direct-debits/{mandateId}

Request

  • Base URL
    https://api.nomba.com
  • URL
    https://api.nomba.com/v1/direct-debits/{mandateId}
  • Auth
    HTTP bearer

Path parameters

mandateIdstring required

Unique identifier of the mandate

Headers

accountIdstring required

The vendor account ID

Response

Mandate details fetched successfully

codestring required
descriptionstring required
messagestring required
statusboolean required

Example response

{
  "code": "00",
  "description": "SUCCESS",
  "data": {
    "status": "ACTIVE",
    "customerAccountNumber": "014453434",
    "customerAccountName": "Kolapo Ojo",
    "bankCode": "057",
    "amount": 100,
    "customerName": "Kolapo Ojo",
    "customerAddress": "maryland Ikeja computer village",
    "customerEmail": "kolapo@gmail.com",
    "customerPhoneNumber": "080456414423",
    "merchantReference": "12003074001",
    "frequency": "VARIABLE",
    "startDate": [
      2025,
      8,
      13,
      15,
      30
    ],
    "endDate": [
      2025,
      8,
      30,
      10,
      40
    ],
    "mandateId": "e50b7835-502c-4cfe-8828-47657633d7a2"
  },
  "message": "SUCCESS",
  "status": true
}

Changes