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

# GET /abdm/v1/request

`GET /abdm/v1/request`

## Query parameters

- `id` string, required — Consent/Subscription ID
- `type` 'consent' | 'subscription' — Request type
- `status` 'requested' | 'granted' | 'expired' | 'denied' | 'revoked' — Status of the request
- `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

- DetailsResponse
  - `access_mode` 'view'
  - `created_at` string, date-time
  - `duration` CommonsDuration
    - `from` string, date-time — Start time of the consent
    - `to` string, date-time — End time of the consent
  - `erase_at` string, date-time
  - `hi_types` CommonsHiType[] — List of HI Types
    - `display` string — Display name of the Health Information Type
    - `enabled` boolean — Is the Health Information Type enabled
    - `id` 'OPConsultation' | 'Prescription' | 'DischargeSummary' | 'DiagnosticReport' | 'ImmunizationRecord' | 'HealthDocumentRecord' | 'WellnessRecord' — Health Information Type ID
  - `hiu` CommonsHiu
    - `id` string — Health Information User ID
    - `name` string — Name of the Health Information User
  - `id` string
  - `providers` DetailsProviders[] — List of Providers/Failities details
    - `care_contexts` DetailsCareContext[]
      - `display` string
      - `id` string
    - `consent_artefact_id` unknown
    - `hip` CommonsHip
      - `id` string — Health Information Provider ID
      - `name` string — Name of the Health Information Provider
  - `purpose` CommonsPurpose
    - `code` string
    - `text` string
  - `requester` CommonsRequester
    - `name` string — Name of the requester.
  - `status` 'requested' | 'granted' | 'expired' | 'denied' | 'revoked'
  - `updated_at` string, date-time

## 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)