---
title: "Get mandate status"
method: GET
path: "/v2/mandates/{resourceId}/status"
---

# Get mandate status

`GET /v2/mandates/{resourceId}/status`

## Request

- Base URL: `https://api.open-finance.ai/v2`
- URL: `https://api.open-finance.ai/v2/v2/mandates/{resourceId}/status`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.open-finance.ai/oauth/token` scopes: `read:mandates`

Can check the status of a mandate resource

## Path parameters

- `resourceId` string, uuid, required

## Response `200`

Response

- GetMandateStatusResponse
  - `mandateStatus` 'received' | 'valid' | 'partiallyAuthorised' | 'rejected' | 'revokedByPSU' | 'expired' | 'terminatedByTPP' | 'suspended': The overall lifecycle status of the mandate
  - `mandateReasonCode` string: Mandate reason code
  - `mandateReasonProprietary` string: Proprietary mandate reason code

## 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.dev/open-finance/apis/data.md) - [All operations](https://skmtc.dev/open-finance/apis/data/llms.txt) - [OpenAPI document](https://skmtc.dev/open-finance/apis/data/revisions/c18eafb2a770?raw)