consent_management

HIU Consent Notification

Notification the gateway sends a HIU when a consent request is granted, denied, revoked or expires.

POST/api/consent-management/consent/request/notify

Authorizations

Authorizationbearer tokenRequired

The access token from POST /api/hiecm/gateway/v3/sessions.

Body

notificationobjectRequired

notification.consentRequestIdstringRequired

notification.statusstringRequired

notification.consentArtefactsobject[]Required

notification.consentArtefacts.idstringRequired

Responses

500

Example values, scrubbed.

Error codes for this module

HIU Consent Notification

curl --request POST \
  --url https://phrsbx.abdm.gov.in/api/consent-management/consent/request/notify \
  --header 'Authorization: Bearer <ACCESS_TOKEN_FROM_SESSIONS_CALL>' \
  --header 'Content-Type: application/json' \
  --data '{
  "notification": {
    "consentRequestId": "<TXN_ID>",
    "status": "DENIED",
    "consentArtefacts": [
      {
        "id": "<TXN_ID>"
      }
    ]
  }
}'

{
  "code": "ABDM-9999: ",
  "message": "Valid consent not found"
}

Generated from the schema. The values are placeholders, not a captured response.