---
title: "Mandates - Retrieve Mandate"
method: GET
path: "/mandates/{mandate_id}"
tags: ["Mandates"]
---

# Mandates - Retrieve Mandate

`GET /mandates/{mandate_id}`

Retrieves a mandate created using the Payments/Create API

## Path parameters

- `mandate_id` string, required

## Response `200`

The mandate was retrieved successfully

- MandateResponse
  - `mandate_id` string, required — The identifier for mandate
  - `status` 'active' | 'inactive' | 'pending' | 'revoked', required — The status of the mandate, which indicates whether it can be used to initiate a payment.
  - `payment_method_id` string, required — The identifier for payment method
  - `payment_method` string, required — The payment method
  - `payment_method_type` string, nullable — The payment method type
  - `card` MandateCardDetails
    - `last4_digits` string, nullable — The last 4 digits of card
    - `card_exp_month` string, nullable — The expiry month of card
    - `card_exp_year` string, nullable — The expiry year of card
    - `card_holder_name` string, nullable — The card holder name
    - `card_token` string, nullable — The token from card locker
    - `scheme` string, nullable — The card scheme network for the particular card
    - `issuer_country` string, nullable — The country code in in which the card was issued
    - `card_fingerprint` string, nullable — A unique identifier alias to identify a particular card
    - `card_isin` string, nullable — The first 6 digits of card
    - `card_issuer` string, nullable — The bank that issued the card
    - `card_network` 'Visa' | 'Mastercard' | 'AmericanExpress' | 'JCB' | 'DinersClub' | 'Discover' | 'CartesBancaires' | 'UnionPay' | 'Interac' | 'RuPay' | 'Maestro' | 'Star' | 'Pulse' | 'Accel' | 'Nyce' | 'Prop' | 'PrivateLabel' | 'Dinacard' — Indicates the card network.
    - `card_type` string, nullable — The type of the payment card
    - `nick_name` string, nullable — The nick_name of the card holder
  - `customer_acceptance` CustomerAcceptance — This "CustomerAcceptance" object is passed during Payments-Confirm request, it enlists the type, time, and mode of acceptance properties related to an acceptance done by the customer. The customer_acceptance sub object is usually passed by the SDK or client.
    - `acceptance_type` 'online' | 'offline', required — This is used to indicate if the mandate was accepted online or offline
    - `accepted_at` string, date-time, nullable — Specifying when the customer acceptance was provided
    - `online` OnlineMandate — Details of online mandate
      - `ip_address` string, required — Ip address of the customer machine from which the mandate was created
      - `user_agent` string, required — The user-agent of the customer's browser

## Other responses

- `404` — Mandate does not exist in our records

---

[API](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0.md) · [All operations](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperswitch/dynamic-routing-openapi-3-0/revisions/8fbf69ab2597/schema)