---
title: "Get mandate by resource ID"
method: GET
path: "/v2/mandates/{resourceId}"
---

# Get mandate by resource ID

`GET /v2/mandates/{resourceId}`

Returns the content of a mandate object

## Path parameters

- `resourceId` string, uuid, required

## Response `200`

Response

- GetMandateResponse
  - `mandateResourceId` string, uuid — Technical resource identification
  - `mandateId` string — Unique identification, as assigned by the creditor, to unambiguously identify the mandate
  - `type` object
    - `localInstrumentCode` string
    - `serviceLevelCode` string
  - `occurrences` object
    - `sequenceType` string
    - `frequencyType` string
    - `firstCollectionDate` string, date
  - `firstCollectionAmount` object
    - `currency` string
    - `amount` string
  - `collectionAmount` object
    - `currency` string
    - `amount` string
  - `maximumAmount` object
    - `currency` string
    - `amount` string
  - `reasonCode` string
  - `reasonProprietary` string
  - `creditorSchemeIdentification` object
    - `name` string
    - `other` object
  - `creditor` object
    - `name` string
    - `other` object
  - `creditorAccount` object
    - `iban` string
    - `bban` string
    - `maskedPan` string
    - `msisdn` string
    - `currency` string
    - `other` object
    - `cashAccountType` string
  - `creditorAgent` object
    - `bic` string
    - `name` string
  - `ultimateCreditor` object
    - `name` string
    - `other` object
  - `debtor` object
    - `name` string
    - `other` object
  - `debtorAccount` object
    - `iban` string
    - `bban` string
    - `maskedPan` string
    - `msisdn` string
    - `currency` string
    - `other` object
    - `cashAccountType` string
  - `ultimateDebtor` object
    - `name` string
    - `other` object
  - `mandateReference` string
  - `referredDocument` object
    - `type` string
    - `number` string
  - `mandateStatus` 'received' | 'valid' | 'partiallyAuthorised' | 'rejected' | 'revokedByPSU' | 'expired' | 'terminatedByTPP' | 'suspended'
  - `lastActionDate` string, date — Date of the last action on the mandate object

## Other responses

- `400` — Validation Error
- `401` — Unauthorized, token is missing
- `403` — Forbidden, token has no valid scopes
- `404` — Not Found, Mandate with this resourceId not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/open-finance/apis/auth.md) · [All operations](https://skmtc.net/open-finance/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/open-finance/auth/versions/b4d401b65c3d/schema)