---
title: "GetDataRecipientsStatus"
method: GET
path: "/{industry}/data-recipients/status"
tags: ["Data Recipients Status"]
---

# GetDataRecipientsStatus

`GET /{industry}/data-recipients/status`

## Request

- Base URL: `/cdr-register/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/cdr-register/v1/{industry}/data-recipients/status`
- Auth: none declared

Endpoint used by participants to discover the statuses for Data Recipients from the CDR Register

## Path parameters

- `industry` 'banking', required

## Headers

- `x-v` string

## Response `200`

Success

- DataRecipientsStatusList
  - `dataRecipients` DataRecipientStatus[], required
    - `dataRecipientId` string, required: Unique id of the Data Recipient issued by the CDR Register. Refer to [Identifiers](https://cdr-register.github.io/register/#identifiers) for details
    - `dataRecipientStatus` 'ACTIVE' | 'SUSPENDED' | 'REVOKED' | 'SURRENDERED', required: Data Recipient status in the CDR Register

## Other responses

- `400`: Bad Request</br>Invalid industry path parameter
- `406`: Invalid x-v header</br>Invalid Accept header

## Changes

- **2026-07-17** `d9372f7f0091`: 1 info
  - api operation id `GetDataRecipientStatus` removed and replaced with `GetDataRecipientsStatus`
- **2020-04-19** `9fbbc87a7e70`: 1 info
  - added the non-success response with the status `406`
- **2019-10-24** `e3ded3ba1f20`: 1 info
  - endpoint added
- **2019-06-11** `46a7751db141`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/gov/apis/consumer-data-right-cdr-register-participant-discovery-apis/changes/:industry/data-recipients/status/get.md)

---

[API](https://skmtc.dev/gov/apis/consumer-data-right-cdr-register-participant-discovery-apis.md) - [All operations](https://skmtc.dev/gov/apis/consumer-data-right-cdr-register-participant-discovery-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/gov/apis/consumer-data-right-cdr-register-participant-discovery-apis/revisions/d9372f7f0091?raw)
