---
title: "Get Mandate by ID"
method: GET
path: "/v1/direct-debits/{mandateId}"
tags: ["Direct Debits"]
---

# Get Mandate by ID

`GET /v1/direct-debits/{mandateId}`

## Request

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

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

## Path parameters

- `mandateId` string, required

## Headers

- `accountId` string, required

## Response `200`

Mandate details fetched successfully

- GetMandateByIdResponse
  - `code` string, required
  - `description` string, required
  - `data` object, required
    - `status` string, required
    - `customerAccountNumber` string, required
    - `customerAccountName` string, required
    - `bankCode` string, required
    - `amount` number, double, required
    - `customerName` string, required
    - `customerAddress` string
    - `customerEmail` string
    - `customerPhoneNumber` string
    - `merchantReference` string, required
    - `frequency` string, required
    - `startDate` integer[], required
    - `endDate` integer[], required
    - `mandateAdviceStatus` string
    - `mandateId` string, required
  - `message` string, required
  - `status` boolean, required

## Other responses

- `400`: The request body sent by merchant did not pass the validation checks
- `401`: The access_token provided to access the resource is missing or invalid.
- `403`: The client does not have the permissions to access this resource
- `404`: The record that the client is trying to access does not exist.
- `429`: The client has maxed out the number of calls within a time period on this resource.
- `500`: Downstream system error.
- `default`: Resource not available

## Changes

- **2026-11-03** `278a25dccfe5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nomba/apis/vendor-api/changes/v1/direct-debits/:mandateId/get.md)

---

[API](https://skmtc.dev/nomba/apis/vendor-api.md) - [All operations](https://skmtc.dev/nomba/apis/vendor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nomba/apis/vendor-api/revisions/278a25dccfe5?raw)