---
title: "GET /abdm/v1/requests"
method: GET
path: "/abdm/v1/requests"
---

# GET /abdm/v1/requests

`GET /abdm/v1/requests`

API to list all the Subscriptions and Consent requests

## Query parameters

- `status` 'requested' | 'granted' | 'expired' | 'denied' | 'revoked', required — status of the request
- `type` 'consent' | 'subscription' | 'authorization' | 'all', required — Specifies the type of request being queried.
- `oid` string — OID is used to Identify the user.

## Headers

- `X-Pt-Id` string
- `X-Partner-Pt-Id` string
- `X-Hip-Id` string

## Response `200`

OK

- ListsResponse
  - `authorizations` ListsRequestDetail[] — List of authorizations
    - `created_at` string, date-time — Time when the consent was created
    - `duration` CommonsDuration
      - `from` string, date-time — Start time of the consent
      - `to` string, date-time — End time of the consent
    - `hiu` CommonsHiu
      - `id` string — Health Information User ID
      - `name` string — Name of the Health Information User
    - `id` string — Unique identifier for the consent/authorization/subscription
    - `purpose` CommonsPurpose
      - `code` string
      - `text` string
    - `requester` CommonsRequester
      - `name` string — Name of the requester.
  - `consents` ListsRequestDetail[] — List of consents
    - `created_at` string, date-time — Time when the consent was created
    - `duration` CommonsDuration
      - `from` string, date-time — Start time of the consent
      - `to` string, date-time — End time of the consent
    - `hiu` CommonsHiu
      - `id` string — Health Information User ID
      - `name` string — Name of the Health Information User
    - `id` string — Unique identifier for the consent/authorization/subscription
    - `purpose` CommonsPurpose
      - `code` string
      - `text` string
    - `requester` CommonsRequester
      - `name` string — Name of the requester.
  - `subscriptions` ListsRequestDetail[] — List of subscriptions
    - `created_at` string, date-time — Time when the consent was created
    - `duration` CommonsDuration
      - `from` string, date-time — Start time of the consent
      - `to` string, date-time — End time of the consent
    - `hiu` CommonsHiu
      - `id` string — Health Information User ID
      - `name` string — Name of the Health Information User
    - `id` string — Unique identifier for the consent/authorization/subscription
    - `purpose` CommonsPurpose
      - `code` string
      - `text` string
    - `requester` CommonsRequester
      - `name` string — Name of the requester.

## Other responses

- `4XX`
- `5XX`

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/versions/9ea23456f722/schema)