{"openapi":"3.0.0","servers":[{"description":"Sandbox","url":"https://dev.ndhm.gov.in/gateway"}],"info":{"contact":{"name":"National Health Authority","url":"https://ndhm.gov.in/"},"description":"Gateway is the hub that routes/orchestrates the interaction between consent managers and API bridges. There are 5 categories of APIs; discovery, link, consent flow, data flow and  monitoring. To reflect the consumers of APIs, the above apis are also categorized under cm facing, hiu facing and hip facing \n","title":"Gateway","version":"0.5","x-apisguru-categories":["open_data"],"x-origin":[{"format":"openapi","url":"https://apisetu.gov.in/api_specification_v8/ndhm-gateway.yaml","version":"3.0"}],"x-providerName":"ndhm.gov.in","x-serviceName":"ndhm-gateway"},"tags":[{"name":"user auth"},{"name":"profile"},{"name":"discovery"},{"name":"link"},{"name":"consent flow"},{"name":"data flow"},{"name":"identification"},{"name":"monitoring"},{"name":"sessions"},{"name":"subscriptions"},{"name":"services"},{"name":"cm facing"},{"name":"hiu facing"},{"name":"hip facing"}],"paths":{"/v0.5/.well-known/openid-configuration":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenIdConfiguration"}},"application/xml":{"schema":{"$ref":"#/components/schemas/OpenIdConfiguration"}}},"description":"OK"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid consent request id\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Get openid configuration","tags":["sessions"]}},"/v0.5/care-contexts/discover":{"post":{"description":"Request for patient care context discover, made by CM for a specific HIP. It is expected that HIP will subsequently return either zero or one patient record with (potentially masked) associated care contexts\n  1. **At least one of the verified identifier matches**\n  2. **Name (fuzzy), gender matches**\n  3. **If YoB was given, age band(+-2) matches**\n  4. **If unverified identifiers were given, one of them matches**\n  5. **If more than one patient records would be found after aforementioned steps, then patient who matches most verified and unverified identifiers would be returned.**\n  6. **If there would be still more than one patients (after ranking) error would be returned**\n  7. **Intended HIP should be able to resolve and identify results returned in the subsequent link confirmation request via the specified transactionId**\n  8. **Intended HIP should store the discovery results with transactionId and care contexts discovered for subsequent link initiation**\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientDiscoveryRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientDiscoveryRequest"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Empty verified identifiers.\n  * Format mismatch of any of attributes.\n    | type   | Format/Allowed Values|\n    | ------- | ----------------    |\n    | gender  | M/F/O/U |\n    | MOBILE  | valid mobile number with proper country code |\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Discover patient's accounts","tags":["discovery","cm facing"]}},"/v0.5/care-contexts/on-discover":{"post":{"description":"Result of patient care-context discovery request at HIP end. If a matching patient found with zero or more care contexts associated, it is specified as result attribute. If the prior discovery request, resulted in errors then it is specified in the error attribute. Reasons of errors can be \n  1. **more than one definitive match for the given request** \n  2. **no verified identifer was specified**\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientDiscoveryResult"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientDiscoveryResult"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Format mismatch of any of attributes.\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Response to patient's account discovery request","tags":["discovery","cm facing"]}},"/v0.5/certs":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Certs"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Certs"}}},"description":"OK"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid consent request id\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Get certs for JWT verification","tags":["sessions"]}},"/v0.5/consent-requests/init":{"post":{"description":"Creates a consent request to get data about a patient by HIU user.","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConsentRequest"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent \n  * Required attributes not mentioned\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Create consent request","tags":["consent flow","hiu facing"]}},"/v0.5/consent-requests/on-init":{"post":{"description":"Result of consent request creation for a patient. **consentRequest.id** represents the consentrequest id created by CM. The result must contain either **consentRequest** or the **error** caused. <br/>\n  Reasons for error may be\n  * Invalid references (e.g patient id, hiu id), purpose, hiTypes, ranges, persmission\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRequestInitResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConsentRequestInitResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Response to consent request","tags":["consent flow","cm facing"]}},"/v0.5/consent-requests/on-status":{"post":{"description":"Result of consent request done previously. Status of request can be GRANTED,  DENIED, EXPIRED. If the request was GRANTED, then \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUConsentRequestStatus"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIUConsentRequestStatus"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Result of consent request status","tags":["consent flow","cm facing"]}},"/v0.5/consent-requests/status":{"post":{"description":"Get status of consent request done previously","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRequestStatusRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConsentRequestStatusRequest"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Get consent request status","tags":["consent flow","hiu facing"]}},"/v0.5/consents/fetch":{"post":{"parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentFetchRequest"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Get consent artefact","tags":["consent flow","hiu facing"]}},"/v0.5/consents/hip/notify":{"post":{"description":"Notification of consents to health information providers consent request granted, consent revoked, consent expired. Only the GRANTED, REVOKED and EXPIRED status notifications will be sent to HIP.\n  1. If consent is granted, status=GRANTED, then consentDetail contains the consent artefact details and signature is available. \n  2. If consent is revoked, then status=REVOKED, and consentId specifes which consent artefact is revoked. \n  3. If the consent has expired, then status=EXPIRED, and consentId specifies which consent artefact has expired. Note, this is also responsibility of the HIP to keep track of consent expiry. Any data request on expired consent artefact must not be done. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPConsentNotification"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIPConsentNotification"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid/Expired/Empty token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream services are down\n"}},"summary":"Consent notification","tags":["consent flow","cm facing"]}},"/v0.5/consents/hip/on-notify":{"post":{"description":"This API is called by HIP as acknowledgement to notification of consents, in cases of consent revocation and expiration. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPConsentNotificationResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIPConsentNotificationResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid/Expired/Empty token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream services are down\n"}},"summary":"Consent notification","tags":["consent flow","hip facing"]}},"/v0.5/consents/hiu/notify":{"post":{"description":"Health information user will get notified about the consent request granted or denied, consent revoked, consent expired. \n1. For consent request grant, status=GRANTED, consentRequestId=<consent-request-id>, and consentArtefacts is an array of generated consent artefact Ids.\n2. For consent request expiry, status=EXPIRED, consentRequestId=<consent-request-id>\n3. For consent request denied, status=DENIED, consentRequestId=<consent-request-id>\n4. For consent revocation, status=REVOKED, consentArtefacts is an array of revoked consent artefact ids\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUConsentNotificationEvent"}}},"required":true},"responses":{"202":{"description":"Request Accepted."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid/Expired/Empty token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream services are down\n"}},"summary":"Consent notification","tags":["consent flow","cm facing"]}},"/v0.5/consents/hiu/on-notify":{"post":{"description":"This API is called by HIU as acknowledgement to consent notifications, specifically for cases when consent is REVOKED or EXPIRED.\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUConsentNotificationResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid/Expired/Empty token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream services are down\n"}},"summary":"Consent notification","tags":["consent flow","hiu facing"]}},"/v0.5/consents/on-fetch":{"post":{"description":"Must contain either consentDetail or error. Possible reason of errors are \n1. consentId passed through /fetch is invalid\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentArtefactResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConsentArtefactResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Result of fetch request for a consent artefact","tags":["consent flow","cm facing"]}},"/v0.5/health-information/cm/on-request":{"post":{"description":"Callback API for acknowledgement of Health information request of HIU. CM calls this API when it has validated the Health Information request given the consent id. Either the **hiRequest** or **error** would need to be specified. If the health info request was valid, then the ***hiRequest.transactionId*** specifies the transaction context against which HIP would send over the data.  Possible cases of errors are\n  1. **Invalid consent artefact id**\n  2. **Consent has expired**\n  3. **Date ranges are invalid**\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUHealthInformationRequestResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIUHealthInformationRequestResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Bad request\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Token is invalid or Link has expired\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Health information data request","tags":["data flow","cm facing"]}},"/v0.5/health-information/cm/request":{"post":{"description":"Request for Health information against a consent id. CM would generate a transactionId against each consent and pass it as trnasaction context / correlation id to the HIP and also return the same to HIU via /on-request. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIRequest"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Bad request\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Token is invalid or Link has expired\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Health information data request","tags":["data flow","hiu facing"]}},"/v0.5/health-information/hip/on-request":{"post":{"description":"API called by HIP to acknowledge Health information request receipt. Either the **hiRequest** or **error** must be specified. **hiRequest** element returns the same transactionId as before with a status indicating that the request is acknowledged.  \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPHealthInformationRequestAcknowledgement"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIPHealthInformationRequestAcknowledgement"}}},"required":true},"responses":{"202":{"description":"Request accepted."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Bad request\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Token is invalid or Link has expired\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Health information data request","tags":["data flow","hip facing"]}},"/v0.5/health-information/hip/request":{"post":{"description":"API called by CM to request Health information from HIP against a validated consent artefact. The transactionId is the correlation id that HIP should use use when pushing data to the **dataPushUrl**. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIPHIRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIPHIRequest"}}},"required":true},"responses":{"202":{"description":"Request accepted."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Bad request\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Token is invalid or Link has expired\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Health information data request","tags":["data flow","cm facing"]}},"/v0.5/health-information/notify":{"post":{"description":"API called by HIU and HIP during data-transfer. \n1. HIP on transfer of data would send **sessionStatus** - one of [TRANSFERRED, FAILED]\n2. HIP would also send **hiStatus** for each *careContextReference* - on of [DELIVERED, ERRORED]\n3. HIU on receipt of data would send **sessionStatus** - one of [TRANSFERRED, FAILED]. For example, FAILED when if data was not sent or if invalid data was sent\n4. HIU would also send **hiStatus** for each *careContextReference* - one of [OK, ERRORED] \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthInformationNotification"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HealthInformationNotification"}}},"required":true},"responses":{"204":{"description":"Notification is Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid Request\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Notifications corresponding to events during data flow","tags":["data flow","hip facing","hiu facing"]}},"/v0.5/heartbeat":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HeartbeatResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HeartbeatResponse"}}},"description":"OK"}},"summary":"Get consent request status","tags":["monitoring"]}},"/v0.5/hi-services/{service-id}":{"get":{"description":"This API is meant for displaying the bridge service details by the serviceId provided .\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/service-id"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceProfileResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ServiceProfileResponse"}}},"description":"service details fetched successfully"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Service doesn't exist."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Get bridge service details/profile by the serviceId provided.","tags":["services"]}},"/v0.5/links/link/add-contexts":{"post":{"description":"API to submit care-context to CM for HIP initiated linking. The API must accompany the \"accessToken\" fetched in the users/auth process.  \n  1. subsequent usage for accessToken may be invalid if it was meant for one-time usage or if it expired\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientCareContextLinkRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientCareContextLinkRequest"}}},"required":true},"responses":{"202":{"description":"accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * required information not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"API for HIP initiated care-context linking for patient","tags":["link","hip facing"]}},"/v0.5/links/link/confirm":{"post":{"description":"API to submit the token that was sent by HIP during the link request. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkConfirmationRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/LinkConfirmationRequest"}}},"required":true},"responses":{"202":{"description":"accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Token is not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Token submission by Consent Manager for link confirmation","tags":["link","cm facing"]}},"/v0.5/links/link/init":{"post":{"description":"Request from CM to links care contexts associated with only one patient\n  1. **Validate account reference number and care context reference number**\n  2. **Validate transactionId in the request with discovery request entry to check whether there was a discovery\n      and were these care contexts discovered or not for a given patient**\n  3. **Before eventual link confirmation, HIP needs to authenticate the request with the patient(eg: OTP verification)**\n  4. **HIP should communicate the mode of authentication of a successful request to Consent Manager**\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientLinkReferenceRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientLinkReferenceRequest"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Consent manager user id is not provided\n  * Patient reference number is not provided\n  * Care context references are not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Link patient's care contexts","tags":["link","cm facing"]}},"/v0.5/links/link/on-add-contexts":{"post":{"description":"If the accessToken is valid for purpose of linking, and specified details provided, CM will send \"acknoweldgement.status\" as SUCCESS. If any error occcurred, for example invalid token, or other required patient or care-context information not provided, then \"error\" attribute conveys so. \n  1. **accessToken must be valid and must be for the purpose of linking**\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientCareContextLinkResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientCareContextLinkResponse"}}},"required":true},"responses":{"202":{"description":"accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * resp not specified\n  * atleast acknowledgement or error should be specified\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"callback API for HIP initiated patient linking /link/add-context","tags":["link","cm facing"]}},"/v0.5/links/link/on-confirm":{"post":{"description":"Returns a list of linked care contexts with patient reference number.\n  1. **Validated and linked account reference number**\n  2. **Validated that the token sent from Consent Manager is same as the one generated by HIP**\n  3. **Verified that same Consent Manager which made the link request is sending the token**\n  4. **Results of unmasked linked care contexts with patient reference number**\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientLinkResult"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientLinkResult"}}},"required":true},"responses":{"202":{"description":"accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * resp not specified\n  * atleast patient or error should be specified\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Token authenticated by HIP, indicating completion of linkage of care-contexts","tags":["link","hip facing"]}},"/v0.5/links/link/on-init":{"post":{"description":"Result of patient care-context link request from HIP end. This happens in context of previous discovery of patient found at HIP end, therefore the link requests ought to be in reference to the patient reference and care-context references previously returned by the HIP. The correlation of discovery and link request is maintained through the transactionId. HIP should have\n  1. **Validated transactionId in the request to check whether there was a discovery done previously, and the link request corresponds to returned patient care care context references**\n  2. **Before returning the response, HIP should have sent an authentication request to the patient(eg: OTP verification)**\n  3. **HIP should communicate the mode of authentication of a successful request**\n  4. **HIP subsequently should expect the token passed via /link/confirm against the link.referenceNumber passed in this call**\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n  \nThe error section in the body, represents the potential errors that may have occurred. Possible reasons:\n  1. **Patient reference number is invalid**\n  2. **Care context reference numbers are invalid**\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientLinkReferenceResult"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientLinkReferenceResult"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Format mismatch of any of attributes.\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Response to patient's care context link request","tags":["link","hip facing"]}},"/v0.5/patients/find":{"post":{"description":"This API is meant for identify to patient given her consent-manager-user-id\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientIdentificationRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientIdentificationRequest"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request, required attributes not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Identify a patient by her consent-manager user-id","tags":["identification","hiu facing"]}},"/v0.5/patients/on-find":{"post":{"description":"If a patient is found then patient.name contains the patients name. \nOtherwise, patient is not provided, and possibly error is raised for invalid requests\nNote in addition to the \"Authorization\" header, one of the following headers must be specified\n1. specify **X-HIU-ID** if the requester is HIU (identified from /find requester.id)\n2. specify **X-HIP-ID** if the requester is HIP (identified from /find requester.id)\n","parameters":[{"$ref":"#/components/parameters/authorization"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientIdentificationResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientIdentificationResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request, required attributes not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Identification result for a consent-manager user-id","tags":["identification","cm facing"]}},"/v0.5/patients/profile/on-share":{"post":{"description":"Result of patient share profile request at HIP end.\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareProfileResult"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ShareProfileResult"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Format mismatch of any of attributes.\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Response to patient's share profile request","tags":["profile"]}},"/v0.5/patients/profile/share":{"post":{"description":"Request for sharing patient's profile details to HIP\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareProfileRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ShareProfileRequest"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid Request\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Share patient profile details","tags":["profile","cm facing"]},"servers":[{"url":"https://your-hrp-server.com"}]},"/v0.5/patients/sms/notify":{"post":{"description":"API to send SMS notifications to patient with custom deeplink.\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientSMSNotifcationRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientSMSNotifcationRequest"}}},"required":true},"responses":{"202":{"description":"accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * required information not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"API for HIP to send SMS notifications to patients","tags":["hip facing","patient notification"]}},"/v0.5/patients/sms/on-notify":{"post":{"description":"If the SMS notification is successfully sent to patient then \"status\" will be \"ACKNOWLEDGED\" with no error.\nIf the SMS notification is failed then \"status\" will be \"ERRORED\" with error.\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientSMSNotifcationResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientSMSNotifcationResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request, required attributes not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Acknowledgment response for SMS notification sent to patient by HIP","tags":["cm facing","patient notification"]}},"/v0.5/sessions":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/SessionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}},"description":"OK"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid client Id or secret.\n"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid consent request id\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Get access token","tags":["sessions"]}},"/v0.5/subscription-requests/cm/init":{"post":{"description":"creates a request for subscription. The subscription categories can be for care-contexts linkages or availability of data against existing care-contexts. Note that the requester must have HIU role","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/SubscriptionRequest"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent \n  * Required attributes not mentioned\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Request for subscription","tags":["subscriptions","hiu facing"]}},"/v0.5/subscription-requests/cm/on-init":{"post":{"description":"This callback API acknowledges the request for subscription from a HIU, and sends back a \"id\" that will be used when the patient/user approves or denies the subscription. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUSubscriptionRequestReceipt"}}},"required":true},"responses":{"202":{"description":"Request Accepted."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid/Expired/Empty token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream services are down\n"}},"summary":"callback API for the /subscription-requests/cm/init to notify a HIU on acceptance/acknowledgement of the request for subscription.","tags":["subscriptions","cm facing"]}},"/v0.5/subscription-requests/hiu/notify":{"post":{"description":"This API is used by CM to notify a HIU to grant or deny a request for subscription, and also to notify that in case an existing subscription is revoked or expired. For notifying that a particular subscription request was GRANTED or DENIED, the **subscriptionRequestId** is passed. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionApprovalNotification"}},"application/xml":{"schema":{"$ref":"#/components/schemas/SubscriptionApprovalNotification"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent \n  * Required attributes not mentioned\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Notification for subscription grant/deny/revoke","tags":["subscriptions","cm facing"]}},"/v0.5/subscription-requests/hiu/on-notify":{"post":{"description":"This API is called by HIU as acknowledgement to subscription request relevant notifications. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUSubscriptionRequestNotificationAcknowledgement"}}},"required":true},"responses":{"202":{"description":"Request Accepted."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid/Expired/Empty token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream services are down\n"}},"summary":"Callback API for /subscription-requests/hiu/notify to acknowledge receipt of notification.","tags":["subscriptions","hiu facing"]}},"/v0.5/subscriptions/hiu/notify":{"post":{"description":"This API is used by CM to notify a HIU for notification relevant to subscription. Notifications are sent to subscribed HIUs whenever a new care-context is linked or new data is available on an existing linked care-context. \n1. if event.category = LINK, then only care-contexts are passed when new care-contexts are linked for patient. \n2. If event.category = DATA, then hiTypes are passed. Care-context is passed only if the subscribed HIU has any valid consent for that care-context\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUSubscriptionNotification"}},"application/xml":{"schema":{"$ref":"#/components/schemas/HIUSubscriptionNotification"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid data sent \n  * Required attributes not mentioned\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Expired/Invalid token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Notification to HIU on basis of a granted subscription","tags":["subscriptions","cm facing"]}},"/v0.5/subscriptions/hiu/on-notify":{"post":{"description":"This API is called by HIU as acknowledgement to consent notifications, specifically for cases when consent is REVOKED or EXPIRED.\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HIUSubscriptionNotificationAcknowledgment"}}},"required":true},"responses":{"202":{"description":"Request Accepted."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Invalid/Expired/Empty token.\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream services are down\n"}},"summary":"Callback API for /subscriptions/hiu/notify to acknowledge receipt of notification.","tags":["subscriptions","hiu facing"]}},"/v0.5/users/auth/confirm":{"post":{"description":"This API is called by HIP/HIUs to confirm authentication of users. The transactionId returned by the previous callback API /users/auth/on-init must be sent. If Authentication is successful the callback API will send an \"access token\" for subsequent purpose specific API calls. Note only **credential.authCode** or **credential.demographic** should be sent\n  1. demographic details are only required for  demographic auth as of now. \n  2. demographic details are required only in MEDIATED cases and if the **auth.mode** so demands. e.g. if **auth.mode** is DEMOGRAPHICS. Usually for demographic authentication, the name, gender and DOB must be exactly as specified in User Account.\n  3. demographic.identifier is optional, however maybe required if authentication so mandates. \n  4. credential.authCode is required for other MEDIATED authentication like MOBILE_OTP, AADHAAR_OTP. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthConfirmRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthConfirmRequest"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * transaction id is not provided or invalid\n  * token or other auth confirmation details not provided or invalid\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Confirmation request sending token, otp or other authentication details from HIP/HIU for confirmation","tags":["user auth","hip facing","hiu facing"]}},"/v0.5/users/auth/fetch-modes":{"post":{"description":"This API is meant for identify supported authentication modes for a patient given a specific purpose\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthModeQueryRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthModeQueryRequest"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request, required attributes not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Get a patient's authentication modes relevant to specified purpose","tags":["user auth","hip facing","hiu facing"]}},"/v0.5/users/auth/init":{"post":{"description":"This API is called by HIPs to initiate authentication of users. A transactionId is retuned by the corresponding callback API for confirmation of user auth.\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthInitRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthInitRequest"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * patient id is not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Initialize authentication from HIP","tags":["user auth","hip facing","hiu facing"]}},"/v0.5/users/auth/notify":{"post":{"description":"This API is called by CM to confirm authentication of users. The transactionId returned is same as that passed in /auth/on-init. The \"auth.status\" conveys whether the request was GRANTED or DENIED.\n\n  1. **auth.accessToken** - is specific to the purpose mentioned in the /auth/init. This token needs to be used for initiating the intended action. For example for HIP initiated linking of care-contexts\n  2. **NOTE**, only one of **X-HIP-ID** or **X-HIU-ID** will be sent as part of header, not both.\n  3. The payload is conditional to the purpose of auth. If purpose specified in /auth/init is KYC or KYC_AND_LINK, then patient details are passed. **auth.accessToken** is passed only if the purpose is LINK or KYC_AND_LINK.\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthNotification"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthNotification"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * required details not provided\n  * neither auth nor error specified \n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"notification API in case of DIRECT mode of authentication by the CM","tags":["user auth","cm facing"]}},"/v0.5/users/auth/on-confirm":{"post":{"description":"This API is called by CM to confirm authentication of users.\n\n  1. **auth.accessToken** - is specific to the purpose mentioned in the /auth/init. This token needs to be used for initiating the intended action. For example for HIP initiated linking of care-contexts\n  2. **NOTE**, only one of **X-HIP-ID** or **X-HIU-ID** will be sent as part of header, not both.     \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthConfirmResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthConfirmResponse"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * required details not provided\n  * neither auth nor error specified \n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"callback API for /auth/confirm (in case of MEDIATED auth) to confirm user authentication or not","tags":["user auth","cm facing"]}},"/v0.5/users/auth/on-fetch-modes":{"post":{"description":"If a patient is found then **auth** attribute contains the supported modes for the specified purpose. \nOtherwise, error is raised for invalid requests or for non-existent id.\nNote in addition to the \"Authorization\" header, one of the following headers must be specified\n1. **X-HIU-ID** if the requester is HIU (identified from /auth/fetch-modes requester.id)\n2. **X-HIP-ID** if the requester is HIP (identified from /auth/fetch-modes requester.id)\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthModeQueryResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthModeQueryResponse"}}},"required":true},"responses":{"202":{"description":"Request Accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid request, required attributes not provided\n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Identification result for a consent-manager user-id","tags":["user auth","cm facing"]}},"/v0.5/users/auth/on-init":{"post":{"description":"If the patient's id is valid, CM will return a transactionId as initialization of user auth. If the request is valid, then 'auth.mode' will convey how the authentication should be done. The authentication can be *mediated* or *direct*. For mediated authentication modes, HIP or HIU is epected to send over relevant code (OTP/token) or demographic info via subsequent API call to /auth/confirm. for direct authentication case, CM will notify requester through/users/auth/notify API. \n\n  1. **auth.mode** conveys whats the mode of authentication is, and what is expected from HIP/HIU in the subsequent /auth/confirm API call. Possible values \n      1. MOBILE_OTP - auth via OTP to registered mobile. Mediated. \n      2. AADHAAR_OTP - auth initiated with Aadhaar with OTP. Mediated. \n      3. DEMOGRAPHICS - auth initiated with demographic verification\n      4. DIRECT - for authentication directly with the patient. e.g. Mobile App, SMS. In this case, the HIP/HIU is not expected to call subsequent /auth/confirm call. CM will do direct authentication with the User (e.g. Mobile App, SMS etc) and will notify requester\n  2. **meta.expiry** conveys the expiry time of the token and the authentication session\n  3. **NOTE**, only one of **X-HIP-ID** or **X-HIU-ID** will be sent as part of header, not both. \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n  \nThe error section in the body, represents the potential errors that may have occurred. Possible reasons:\n  1. Patient id is invalid\n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-HIP-ID"},{"$ref":"#/components/parameters/X-HIU-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthInitResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthInitResponse"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * required information not provided\n  * neither authInit nor error specified \n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"Response to user authentication initialization from HIP","tags":["user auth","cm facing"]}},"/v0.5/users/auth/on-notify":{"post":{"description":"This API is called by HIU/HIPs to confirm acknowledgement for receipt of auth notification is case of DIRECT authentication. \n","parameters":[{"$ref":"#/components/parameters/authorization"},{"$ref":"#/components/parameters/X-CM-ID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAuthNotificationAcknowledgement"}},"application/xml":{"schema":{"$ref":"#/components/schemas/PatientAuthNotificationAcknowledgement"}}},"required":true},"responses":{"202":{"description":"Request accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * required details not provided\n  * neither auth nor error specified \n"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Unauthorized request\n"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"**Causes:**\n  * Downstream system(s) is down.\n  * Unhandled exceptions.\n"}},"summary":"callback API by HIU/HIPs as acknowledgement of auth notification","tags":["user auth","hip facing","hiu facing"]}}},"components":{"parameters":{"ConsentId":{"description":"Consent request's identifier","in":"path","name":"consentId","required":true,"schema":{"format":"uuid","type":"string"}},"ConsentRequestId":{"description":"Consent request's identifier","in":"path","name":"consentRequestId","required":true,"schema":{"format":"uuid","type":"string"}},"LinkRefNumber":{"description":"Reference number for the link request made earlier.","in":"path","name":"linkRefNumber","required":true,"schema":{"$ref":"#/components/schemas/UuidSchema"}},"X-CM-ID":{"description":"Suffix of the consent manager to which the request was intended.","in":"header","name":"X-CM-ID","required":true,"schema":{"type":"string"}},"X-HIP-ID":{"description":"Identifier of the health information provider to which the request was intended.","in":"header","name":"X-HIP-ID","required":true,"schema":{"type":"string"}},"X-HIU-ID":{"description":"Identifier of the health information user to which the request was intended.","in":"header","name":"X-HIU-ID","required":true,"schema":{"type":"string"}},"authorization":{"description":"Access token which was issued after successful login with gateway auth server.","in":"header","name":"Authorization","required":true,"schema":{"type":"string"}},"service-id":{"in":"path","name":"service-id","required":true,"schema":{"type":"string"}}},"schemas":{"AccessTokenValidity":{"properties":{"expiry":{"$ref":"#/components/schemas/TimestampSchema"},"limit":{"description":"number of times, the token can be used","example":"1","type":"integer"},"purpose":{"$ref":"#/components/schemas/PatientAuthPurpose"},"requester":{"$ref":"#/components/schemas/PatientAuthRequester"}},"required":["purpose","requester","expiry","limit"],"type":"object"},"AuthConfirmIdentifier":{"properties":{"type":{"$ref":"#/components/schemas/AuthConfirmIdentifierType"},"value":{"example":"+919800083232","type":"string"}},"required":["type","value"],"type":"object","xml":{"name":"AuthConfirmIdentifier"}},"AuthConfirmIdentifierType":{"enum":["MOBILE"],"type":"string"},"AuthMeta":{"properties":{"expiry":{"example":"2025-08-15T13:51:36.870Z","type":"string"},"hint":{"type":"string"}},"type":"object","xml":{"name":"Meta"}},"AuthenticationMode":{"description":"Subjected to CM specific capability\n 1. MOBILE_OTP - for SMS OTP\n 2. DIRECT - for authentication directly with the patient. e.g. Mobile App, SMS\n 3. AADHAAR_OTP - for auth using OTP sent to Aadhaar number\n 4. DEMOGRAPHICS - for auth using demographic verification.\n","enum":["MOBILE_OTP","DIRECT","DEMOGRAPHICS","AADHAAR_OTP"],"type":"string"},"CareContext":{"properties":{"referenceNumber":{"type":"string"}},"required":["referenceNumber"],"type":"object","xml":{"name":"Tag"}},"CareContextDefinition":{"properties":{"careContextReference":{"example":"Episode1","type":"string"},"patientReference":{"example":"batman@tmh","type":"string"}},"required":["patientReference","careContextReference"],"type":"object"},"CareContextRepresentation":{"properties":{"display":{"type":"string"},"referenceNumber":{"type":"string"}},"required":["referenceNumber","display"],"type":"object","xml":{"name":"Tag"}},"CertificateOrKeyGetSchema":{"properties":{"alg":{"type":"string"},"e":{"type":"string"},"kid":{"type":"string"},"kty":{"type":"string"},"n":{"type":"string"},"use":{"type":"string"},"x5c":{"items":{"description":"A PKIX certificate [RFC5280]","type":"string"},"type":"array"},"x5t":{"type":"string"},"x5t#S256":{"type":"string"}},"type":"object"},"Certs":{"properties":{"keys":{"items":{"$ref":"#/components/schemas/CertificateOrKeyGetSchema"},"type":"array"}},"type":"object"},"ConsentAcknowledgement":{"properties":{"consentId":{"example":"<consent-artefact-id>","type":"string"},"status":{"enum":["OK","UNKNOWN"],"type":"string"}},"required":["status","consentId"],"type":"object"},"ConsentArtefactReference":{"properties":{"id":{"example":"<consent-artefact-id>","type":"string"}},"required":["id"],"type":"object"},"ConsentArtefactResponse":{"properties":{"consent":{"properties":{"consentDetail":{"properties":{"careContexts":{"items":{"properties":{"careContextReference":{"example":"Episode1","type":"string"},"patientReference":{"example":"hinapatel79@hospital","type":"string"}},"required":["patientReference","careContextReference"],"type":"object"},"type":"array"},"consentId":{"format":"uuid","type":"string"},"consentManager":{"allOf":[{"$ref":"#/components/schemas/OrganizationRepresentation"},{"xml":{"name":"consentManager"}}],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"hiTypes":{"items":{"$ref":"#/components/schemas/HITypeEnum"},"type":"array"},"hip":{"allOf":[{"$ref":"#/components/schemas/OrganizationRepresentation"},{"xml":{"name":"hip"}}],"type":"object"},"hiu":{"allOf":[{"$ref":"#/components/schemas/OrganizationRepresentation"},{"xml":{"name":"hiu"}}],"type":"object"},"patient":{"$ref":"#/components/schemas/ConsentManagerPatientID"},"permission":{"$ref":"#/components/schemas/Permission"},"purpose":{"$ref":"#/components/schemas/UsePurpose"},"requester":{"$ref":"#/components/schemas/Requester"},"schemaVersion":{"format":"string","type":"string"}},"required":["consentId","createdAt","patient","careContexts","purpose","hip","hiu","consentManager","hiTypes","permission"],"type":"object"},"signature":{"example":"Signature of CM as defined in W3C standards; Base64 encoded","type":"string"},"status":{"$ref":"#/components/schemas/ConsentStatus"}},"required":["status","consentDetail","signature"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"ConsentFetchRequest":{"properties":{"consentId":{"type":"string"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["consentId","requestId","timestamp"],"type":"object"},"ConsentManagerPatientID":{"properties":{"id":{"example":"hinapatel79@ndhm","format":"<user-id>@ndhm","type":"string","xml":{"attribute":true}}},"type":"object"},"ConsentRequest":{"properties":{"consent":{"properties":{"careContexts":{"items":{"$ref":"#/components/schemas/CareContextDefinition"},"type":"array"},"hiTypes":{"items":{"$ref":"#/components/schemas/HITypeEnum"},"type":"array"},"hip":{"allOf":[{"$ref":"#/components/schemas/OrganizationRepresentation"},{"xml":{"name":"hip"}}],"type":"object"},"hiu":{"allOf":[{"$ref":"#/components/schemas/OrganizationRepresentation"},{"xml":{"name":"hiu"}}],"type":"object"},"patient":{"allOf":[{"$ref":"#/components/schemas/ConsentManagerPatientID"},{"xml":{"name":"patient"}}],"type":"object"},"permission":{"$ref":"#/components/schemas/Permission"},"purpose":{"$ref":"#/components/schemas/UsePurpose"},"requester":{"$ref":"#/components/schemas/Requester"}},"required":["purpose","patient","hiu","requester","hiTypes","permission","consentNotificationUrl"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request.","example":"499a5a4a-7dda-4f20-9b67-e24589627061","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","consent"],"type":"object"},"ConsentRequestInitResponse":{"properties":{"consentRequest":{"properties":{"id":{"description":"id of the consent-request created","example":"f29f0e59-8388-4698-9fe6-05db67aeac46","format":"uuid","type":"string"}},"required":["id"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object","xml":{"name":"ConsentRequestInitResponse"}},"ConsentRequestStatusRequest":{"properties":{"consentRequestId":{"type":"string"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["consentRequestId","requestId","timestamp"],"type":"object"},"ConsentStatus":{"enum":["GRANTED","EXPIRED","DENIED","REQUESTED","REVOKED"],"type":"string"},"Endpoint":{"properties":{"address":{"type":"string"},"connectionType":{"type":"string"},"use":{"type":"string"}},"type":"object"},"Error":{"properties":{"code":{"enum":[1000,10001],"type":"integer"},"message":{"type":"string"}},"type":"object","xml":{"name":"Error"}},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"}},"type":"object","xml":{"name":"ErrorResponse"}},"EventCategoryDetail":{"properties":{"careContext":{"$ref":"#/components/schemas/CareContextDefinition"},"hiTypes":{"items":{"$ref":"#/components/schemas/HITypeEnum"},"type":"array"}},"required":["hiTypes","careContext"],"type":"object"},"HIPConsentNotification":{"properties":{"notification":{"properties":{"consentDetail":{"properties":{"careContexts":{"items":{"properties":{"careContextReference":{"example":"Episode1","type":"string"},"patientReference":{"example":"hinapatel79@hospital","type":"string"}},"required":["patientReference","careContextReference"],"type":"object"},"type":"array"},"consentId":{"format":"uuid","type":"string"},"consentManager":{"allOf":[{"$ref":"#/components/schemas/OrganizationReference"},{"xml":{"name":"consentManager"}}],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"hiTypes":{"items":{"$ref":"#/components/schemas/HITypeEnum"},"type":"array"},"hip":{"allOf":[{"$ref":"#/components/schemas/OrganizationRepresentation"},{"xml":{"name":"hip"}}],"type":"object"},"patient":{"$ref":"#/components/schemas/ConsentManagerPatientID"},"permission":{"$ref":"#/components/schemas/Permission"},"purpose":{"$ref":"#/components/schemas/UsePurpose"},"schemaVersion":{"format":"string","type":"string"}},"required":["consentId","createdAt","patient","careContexts","purpose","hip","hiTypes","permission","consentManager"],"type":"object"},"consentId":{"format":"uuid","type":"string"},"signature":{"example":"Signature of CM as defined in W3C standards; Base64 encoded","type":"string"},"status":{"$ref":"#/components/schemas/ConsentStatus"}},"required":["status","consentId","consentDetail","signature"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","notification"],"type":"object"},"HIPConsentNotificationResponse":{"properties":{"acknowledgement":{"$ref":"#/components/schemas/ConsentAcknowledgement"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"HIPHIRequest":{"properties":{"hiRequest":{"properties":{"consent":{"$ref":"#/components/schemas/consent"},"dataPushUrl":{"type":"string"},"dateRange":{"$ref":"#/components/schemas/dateRange"},"keyMaterial":{"$ref":"#/components/schemas/keyMaterial"}},"required":["consent","dataPushUrl","keyMaterial","dateRange"],"type":"object"},"requestId":{"$ref":"#/components/schemas/UuidSchema"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"},"transactionId":{"$ref":"#/components/schemas/UuidSchema"}},"required":["requestId","timestamp","transactionId","hiRequest"],"type":"object"},"HIPHealthInformationRequestAcknowledgement":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"hiRequest":{"properties":{"sessionStatus":{"enum":["ACKNOWLEDGED"],"type":"string"},"transactionId":{"format":"uuid","type":"string"}},"required":["transactionId","sessionStatus"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"HIRequest":{"properties":{"hiRequest":{"properties":{"consent":{"$ref":"#/components/schemas/consent"},"dataPushUrl":{"type":"string"},"dateRange":{"$ref":"#/components/schemas/dateRange"},"keyMaterial":{"$ref":"#/components/schemas/keyMaterial"}},"required":["consent","dataPushUrl","keyMaterial","dateRange"],"type":"object"},"requestId":{"$ref":"#/components/schemas/UuidSchema"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","hiRequest"],"type":"object"},"HITypeEnum":{"enum":["OPConsultation","Prescription","DischargeSummary","DiagnosticReport"],"type":"string","xml":{"name":"HIType"}},"HIUConsentNotificationEvent":{"properties":{"notification":{"properties":{"consentArtefacts":{"description":"if the status is GRANTED or REVOKED, then the consentArtefact references (Ids) must be specified.","items":{"$ref":"#/components/schemas/ConsentArtefactReference"},"type":"array"},"consentRequestId":{"example":"<consent-request-id>","type":"string"},"status":{"$ref":"#/components/schemas/ConsentStatus"}},"required":["status","consentRequestId"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","notification"],"type":"object"},"HIUConsentNotificationResponse":{"properties":{"acknowledgement":{"items":{"$ref":"#/components/schemas/ConsentAcknowledgement"},"type":"array"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"HIUConsentRequestStatus":{"properties":{"consentRequest":{"properties":{"consentArtefacts":{"items":{"$ref":"#/components/schemas/ConsentArtefactReference"},"type":"array"},"id":{"example":"<consent-request-id>","type":"string"},"status":{"$ref":"#/components/schemas/ConsentStatus"}},"required":["id","status"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"HIUHealthInformationRequestResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"hiRequest":{"properties":{"sessionStatus":{"enum":["REQUESTED","ACKNOWLEDGED"],"type":"string"},"transactionId":{"$ref":"#/components/schemas/UuidSchema"}},"required":["transactionId","sessionStatus"],"type":"object"},"requestId":{"$ref":"#/components/schemas/UuidSchema"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"HIUSubscription":{"properties":{"hiu":{"$ref":"#/components/schemas/OrganizationRepresentation"},"id":{"example":"subscription Id","type":"string"},"patient":{"$ref":"#/components/schemas/ConsentManagerPatientID"},"sources":{"items":{"$ref":"#/components/schemas/HIUSubscriptionContext"},"type":"array"}},"required":["id","patient","hiu","sources"],"type":"object"},"HIUSubscriptionContext":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/SubscriptionCategory"},"type":"array"},"hip":{"$ref":"#/components/schemas/OrganizationRepresentation"},"period":{"$ref":"#/components/schemas/SubscriptionPeriod"}},"required":["categories","period"],"type":"object"},"HIUSubscriptionEventContent":{"properties":{"context":{"items":{"$ref":"#/components/schemas/EventCategoryDetail"},"type":"array"},"hip":{"$ref":"#/components/schemas/OrganizationRepresentation"},"patient":{"$ref":"#/components/schemas/ConsentManagerPatientID"}},"required":["patient","hip","context"],"type":"object"},"HIUSubscriptionNotification":{"properties":{"event":{"properties":{"category":{"$ref":"#/components/schemas/SubscriptionCategory"},"content":{"$ref":"#/components/schemas/HIUSubscriptionEventContent"},"id":{"$ref":"#/components/schemas/UuidSchema"},"published":{"$ref":"#/components/schemas/TimestampSchema"},"subscriptionId":{"example":"subscription Id","type":"string"}},"required":["id","published","subscriptionId","category","content"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","event"],"type":"object"},"HIUSubscriptionNotificationAcknowledgment":{"properties":{"acknowledgement":{"properties":{"eventId":{"example":"subscription event Id","type":"string"},"status":{"enum":["OK"],"type":"string"}},"required":["status","eventId"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"HIUSubscriptionRequestNotificationAcknowledgement":{"properties":{"acknowledgement":{"properties":{"status":{"enum":["OK"],"type":"string"},"subscriptionRequestId":{"example":"subscription Id","type":"string"}},"required":["status","subscriptionRequestId"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"HIUSubscriptionRequestReceipt":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"subscriptionRequest":{"properties":{"id":{"description":"id of the consent-request created","example":"f29f0e59-8388-4698-9fe6-05db67aeac46","format":"uuid","type":"string"}},"required":["id"],"type":"object"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object","xml":{"name":"ConsentRequestInitResponse"}},"HealthInformationNotification":{"properties":{"notification":{"properties":{"consentId":{"$ref":"#/components/schemas/UuidSchema"},"doneAt":{"format":"date-time","type":"string"},"notifier":{"properties":{"id":{"example":"tmh","type":"string"},"type":{"enum":["HIU","HIP"],"type":"string"}},"required":["type","id"],"type":"object"},"statusNotification":{"properties":{"hipId":{"example":"max","type":"string"},"sessionStatus":{"enum":["TRANSFERRED","FAILED"],"type":"string"},"statusResponses":{"items":{"properties":{"careContextReference":{"type":"string"},"description":{"type":"string"},"hiStatus":{"enum":["DELIVERED","OK","ERRORED"],"example":"OK","type":"string"}},"required":["careContextReference","hiStatus"],"type":"object"},"type":"array"}},"required":["sessionStatus","hipId"],"type":"object"},"transactionId":{"$ref":"#/components/schemas/UuidSchema"}},"required":["consentId","transactionId","doneAt","notifier","statusNotification"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request.","example":"499a5a4a-7dda-4f20-9b67-e24589627061","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","notification"],"type":"object"},"HeartbeatResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"status":{"enum":["UP","DOWN"],"type":"string"},"timestamp":{"format":"date-time","type":"string","xml":{"attribute":true}}},"type":"object","xml":{"name":"HeartbeatResponse"}},"Identifier":{"properties":{"type":{"$ref":"#/components/schemas/IdentifierType"},"value":{"example":"+919800083232","type":"string"}},"type":"object","xml":{"name":"Identifier"}},"IdentifierType":{"enum":["MOBILE","MR","NDHM_HEALTH_NUMBER","HEALTH_ID"],"type":"string"},"LinkConfirmationRequest":{"properties":{"confirmation":{"properties":{"linkRefNumber":{"type":"string"},"token":{"type":"string"}},"required":["linkRefNumber","token"],"type":"object"},"requestId":{"format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","confirmation"],"type":"object"},"Meta":{"properties":{"communicationExpiry":{"example":"2025-08-15T13:51:36.871Z","type":"string"},"communicationHint":{"type":"string"},"communicationMedium":{"enum":["MOBILE","EMAIL"],"type":"string"}},"required":["mode","value"],"type":"object","xml":{"name":"Meta"}},"OpenIdConfiguration":{"properties":{"jwks_uri":{"example":"https://ndhm-gateway/certs","format":"uri","type":"string"}},"type":"object"},"OrganizationReference":{"properties":{"id":{"type":"string","xml":{"attribute":true}}},"required":["id"],"type":"object","xml":{"name":"OrganizationReference"}},"OrganizationRepresentation":{"properties":{"id":{"type":"string","xml":{"attribute":true}}},"required":["id"],"type":"object","xml":{"name":"OrganizationResponse"}},"PatientAddress":{"properties":{"district":{"type":"string"},"line":{"type":"string"},"pincode":{"type":"string"},"state":{"type":"string"}},"type":"object"},"PatientAuthConfirmRequest":{"properties":{"credential":{"description":"note, demographic details are only required for demographic auth at this point.","properties":{"authCode":{"type":"string"},"demographic":{"$ref":"#/components/schemas/PatientDemographic"}},"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"},"transactionId":{"type":"string"}},"required":["requestId","timestamp","transactionId","credential"],"type":"object"},"PatientAuthConfirmResponse":{"properties":{"auth":{"description":"depending on the purpose of auth, as specified in /auth/init, the response may include the following \n  1. LINK - only returns **accessToken**\n  2. KYC - only returns **patient**\n  3. KYC_AND_LINK - returns both **accessToken** and **patient**\n","properties":{"accessToken":{"description":"access token for initialization of subsequent action.","type":"string"},"patient":{"$ref":"#/components/schemas/PatientDemographicResponse"},"validity":{"$ref":"#/components/schemas/AccessTokenValidity"}},"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"PatientAuthInitRequest":{"properties":{"query":{"properties":{"authMode":{"$ref":"#/components/schemas/AuthenticationMode"},"id":{"description":"id  of the patient understood by the CM","example":"hinapatel@ndhm","type":"string"},"purpose":{"$ref":"#/components/schemas/PatientAuthPurpose"},"requester":{"$ref":"#/components/schemas/PatientAuthRequester"}},"required":["id","requester","purpose"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","query"],"type":"object"},"PatientAuthInitResponse":{"properties":{"auth":{"properties":{"meta":{"$ref":"#/components/schemas/AuthMeta"},"mode":{"$ref":"#/components/schemas/AuthenticationMode"},"transactionId":{"type":"string"}},"required":["transactionId","mode"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"PatientAuthModeQueryRequest":{"properties":{"query":{"properties":{"id":{"example":"hinapatel79@ndhm","type":"string"},"purpose":{"$ref":"#/components/schemas/PatientAuthPurpose"},"requester":{"properties":{"id":{"example":"100005","type":"string"},"type":{"enum":["HIP","HIU"],"type":"string"}},"required":["id","type"],"type":"object"}},"required":["id","purpose","requester"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","query"],"type":"object"},"PatientAuthModeQueryResponse":{"properties":{"auth":{"properties":{"modes":{"items":{"$ref":"#/components/schemas/AuthenticationMode"},"type":"array"},"purpose":{"$ref":"#/components/schemas/PatientAuthPurpose"}},"required":["purpose","modes"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"PatientAuthNotification":{"properties":{"auth":{"description":"depending on the purpose of auth, as specified in /auth/init, the response may include the following \n  1. LINK - only returns **accessToken**\n  2. KYC - only returns **patient**\n  3. KYC_AND_LINK - returns both **accessToken** and **patient**\n","properties":{"accessToken":{"description":"access token for initialization of subsequent action.","type":"string"},"patient":{"$ref":"#/components/schemas/PatientDemographicResponse"},"status":{"enum":["GRANTED","DENIED"],"type":"string"},"transactionId":{"description":"transaction id for auth session","type":"string"},"validity":{"$ref":"#/components/schemas/AccessTokenValidity"}},"required":["transactionId","status"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","transactionId"],"type":"object"},"PatientAuthNotificationAcknowledgement":{"properties":{"acknowledgement":{"properties":{"status":{"enum":["OK"],"type":"string"}},"required":["status"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"PatientAuthPurpose":{"description":"what is the purpose of user auth","enum":["LINK","KYC","KYC_AND_LINK"],"type":"string"},"PatientAuthRequester":{"description":"identification of requester","properties":{"id":{"example":100005,"type":"string"},"type":{"enum":["HIP","HIU"],"type":"string"}},"required":["type","id"],"type":"object"},"PatientCareContextLink":{"properties":{"accessToken":{"description":"AccessToken fetched in the user auth process for the purpose specified","type":"string"},"patient":{"properties":{"careContexts":{"items":{"$ref":"#/components/schemas/CareContextRepresentation"},"type":"array","xml":{"name":"careContexts","wrapped":true}},"display":{"type":"string"},"referenceNumber":{"description":"patient reference id at HIP","example":"TMH-PUID-001","type":"string"}},"required":["referenceNumber","display","careContexts"],"type":"object"}},"required":["accessToken","patient"],"type":"object"},"PatientCareContextLinkRequest":{"properties":{"link":{"$ref":"#/components/schemas/PatientCareContextLink"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","link"],"type":"object"},"PatientCareContextLinkResponse":{"properties":{"acknowledgement":{"properties":{"status":{"enum":["SUCCESS"],"type":"string"}},"required":["status"],"type":"object"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"PatientDemographic":{"description":"Demographic details are only required for demographic auth at this point. Demographic details must be same as registered","properties":{"dateOfBirth":{"description":"date of birth in YYYY-MM-DD format.","example":"2025-08-15T13:51:36.871Z","type":"string"},"gender":{"$ref":"#/components/schemas/PatientGender"},"identifier":{"$ref":"#/components/schemas/AuthConfirmIdentifier"},"name":{"example":"janki das","type":"string"}},"required":["name","gender","dateOfBirth"],"type":"object"},"PatientDemographicResponse":{"properties":{"address":{"$ref":"#/components/schemas/PatientAddress"},"gender":{"$ref":"#/components/schemas/PatientGender"},"id":{"description":"PHR Identifier of patient at consent manager","example":"<patient-id>@<consent-manager-id>","type":"string"},"identifiers":{"items":{"$ref":"#/components/schemas/Identifier"},"type":"array","xml":{"name":"identifiers","wrapped":true}},"name":{"example":"Hina Patel","type":"string"},"yearOfBirth":{"example":2000,"type":"integer"}},"required":["id","name","gender","yearOfBirth"],"type":"object"},"PatientDiscoveryRequest":{"properties":{"patient":{"properties":{"gender":{"$ref":"#/components/schemas/PatientGender"},"id":{"description":"Identifier of patient at consent manager","example":"<patient-id>@<consent-manager-id>","type":"string"},"name":{"example":"chandler bing","type":"string"},"unverifiedIdentifiers":{"items":{"$ref":"#/components/schemas/Identifier"},"type":"array","xml":{"name":"unverifiedIdentifiers","wrapped":true}},"verifiedIdentifiers":{"items":{"$ref":"#/components/schemas/Identifier"},"type":"array","xml":{"name":"verifiedIdentifiers","wrapped":true}},"yearOfBirth":{"example":2000,"type":"integer"}},"required":["id","verifiedIdentifiers","name","gender","yearOfBirth"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request.","example":"499a5a4a-7dda-4f20-9b67-e24589627061","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"},"transactionId":{"description":"correlation-Id for patient discovery and subsequent care context linkage","format":"uuid","type":"string"}},"required":["requestId","timestamp","transactionId","patient"],"type":"object","xml":{"name":"PatientDiscoveryRequest"}},"PatientDiscoveryResult":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"patient":{"$ref":"#/components/schemas/PatientRepresentation"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"},"transactionId":{"format":"uuid","type":"string"}},"required":["requestId","transactionId","timestamp","resp"],"type":"object","xml":{"name":"PatientDiscoveryResult"}},"PatientGender":{"enum":["M","F","O","U"],"type":"string"},"PatientIdentificationRequest":{"properties":{"query":{"properties":{"patient":{"properties":{"id":{"example":"hinapatel79@ndhm","type":"string"}},"type":"object"},"requester":{"properties":{"id":{"example":100005,"type":"string"},"type":{"enum":["HIU","HIP"],"type":"string"}},"type":"object"}},"required":["patient","requester"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","query"],"type":"object"},"PatientIdentificationResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"patient":{"properties":{"id":{"example":"hinapatel79@ndhm","type":"string"},"name":{"example":"Hina Patel","type":"string"}},"required":["id","name"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object","xml":{"name":"PatientIdentificationResponse"}},"PatientLinkReferenceRequest":{"properties":{"patient":{"properties":{"careContexts":{"items":{"$ref":"#/components/schemas/CareContext"},"type":"array","xml":{"name":"careContexts","wrapped":true}},"id":{"description":"Identifier of patient at consent manager","example":"hinapatel79@ndhm","type":"string"},"referenceNumber":{"example":"TMH-PUID-001","type":"string"}},"required":["id","referenceNumber","careContexts"],"type":"object"},"requestId":{"format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"},"transactionId":{"format":"uuid","type":"string"}},"required":["requestId","timestamp","transactionId","patient"],"type":"object","xml":{"name":"PatientLinkReferenceRequest"}},"PatientLinkReferenceResult":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"link":{"properties":{"authenticationType":{"enum":["DIRECT","MEDIATED"],"type":"string"},"meta":{"$ref":"#/components/schemas/Meta"},"referenceNumber":{"type":"string"}},"required":["referenceNumber","authenticationType"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"},"transactionId":{"$ref":"#/components/schemas/UuidSchema"}},"required":["requestId","timestamp","transactionId","resp"],"type":"object"},"PatientLinkResult":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"patient":{"properties":{"careContexts":{"items":{"$ref":"#/components/schemas/CareContextRepresentation"},"type":"array"},"display":{"type":"string"},"referenceNumber":{"type":"string"}},"required":["referenceNumber","display","careContexts"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"PatientRepresentation":{"properties":{"careContexts":{"items":{"$ref":"#/components/schemas/CareContextRepresentation"},"type":"array"},"display":{"type":"string"},"matchedBy":{"items":{"$ref":"#/components/schemas/IdentifierType"},"type":"array"},"referenceNumber":{"type":"string"}},"required":["referenceNumber","display"],"type":"object","xml":{"name":"Patient"}},"PatientSMSNotifcationRequest":{"properties":{"notification":{"properties":{"careContextInfo":{"description":"Information about care context or visit for which the SMS is being sent.","example":"X-Ray on 22nd Dec","type":"string"},"deeplinkUrl":{"description":"A link pointing to digital health records of the patient. PHR App's deeplink will be sent in SMS if this field is not provided.","example":"https://link.to.health.records/ (Optional)","format":"uri","type":"string"},"hip":{"properties":{"id":{"description":"Registered id of the HIP.","example":"HIP_001","type":"string"},"name":{"description":"Name of the HIP(Hospital). Hospital's name will be fetched from registry if not provided.","example":"Max Healthcare (Optional)","type":"string"}},"required":["id"],"type":"object"},"phoneNo":{"description":"Phone number of the receiver with country code","example":"+91-9999999999","type":"string"},"receiverName":{"description":"Name of the reciever/patient. Receiver's name will not be sent if not provided.","example":"Ramesh Singh (Optional)","type":"string"}},"required":["phoneNo","hip","careContextInfo"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","notification"],"type":"object"},"PatientSMSNotifcationResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"status":{"enum":["ACKNOWLEDGED","ERRORED"],"type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","resp"],"type":"object"},"Permission":{"properties":{"accessMode":{"enum":["VIEW","STORE","QUERY","STREAM"],"type":"string"},"dataEraseAt":{"format":"date-time","type":"string"},"dateRange":{"properties":{"from":{"format":"date-time","type":"string"},"to":{"format":"date-time","type":"string"}},"type":"object"},"frequency":{"properties":{"repeats":{"type":"integer"},"unit":{"enum":["HOUR","WEEK","DAY","MONTH","YEAR"],"type":"string"},"value":{"type":"integer"}},"type":"object"}},"required":["accessMode","dateRange","dataEraseAt","frequency"],"type":"object","xml":{"name":"Permission"}},"RequestReference":{"properties":{"requestId":{"description":"the requestId that was passed","format":"uuid","type":"string"}},"required":["requestId"],"type":"object"},"Requester":{"properties":{"identifier":{"properties":{"system":{"example":"https://www.mciindia.org","type":"string"},"type":{"example":"REGNO","type":"string"},"value":{"example":"MH1001","type":"string"}},"type":"object"},"name":{"example":"Dr. Manju","type":"string"}},"required":["name"],"type":"object"},"ServiceProfileResponse":{"properties":{"active":{"type":"boolean"},"endpoints":{"items":{"$ref":"#/components/schemas/Endpoint"},"type":"array"},"id":{"type":"string"},"name":{"type":"string"},"type":{"$ref":"#/components/schemas/ServiceRole"}},"type":"object","xml":{"name":"ServiceProfileResponse"}},"ServiceRole":{"enum":["HIP","HIU","HIP_AND_HIU","HEALTH_LOCKER"],"type":"string"},"SessionRequest":{"properties":{"clientId":{"type":"string"},"clientSecret":{"type":"string"},"grantType":{"enum":["client_credentials","refresh_token"],"type":"string"},"refreshToken":{"type":"string"}},"required":["clientId","clientSecret","grantType"],"type":"object"},"SessionResponse":{"properties":{"accessToken":{"example":"eyJhbGciOiJSUzI1Ni.IsInR5cCIgOiAiSldUIiwia2lkIiA6ICJrVVp.2MXJQMjRyYXN1UW9wU2lWbkdZQUZIVFowYVZGVWpYNXFLMnNibTk0In0","type":"string"},"expiresIn":{"description":"In Minutes","example":1800,"type":"integer"},"refreshExpiresIn":{"description":"In Minutes","example":1800,"type":"integer"},"refreshToken":{"example":"eyJhbGciOiJSUzI1Ni.IsInR5cCIgOiAiSldUIiwia2lkIiA6ICJrVVp.2MXJQMjRyYXN1UW9wU2lWbkdZQUZIVFowYVZGVWpYNXFLMnNibTk0In0","type":"string"},"tokenType":{"example":"bearer","type":"string"}},"type":"object"},"ShareProfileAcknowledgement":{"properties":{"healthId":{"example":"<username>@<suffix>","type":"string"},"status":{"enum":["SUCCESS","FAILURE"],"type":"string"}},"required":["status","healthId"],"type":"object"},"ShareProfileRequest":{"properties":{"patient":{"properties":{"hipCode":{"description":"additional details about HIP retrieved after scanning QR.","example":"12345 (CounterId)","type":"string"},"userDemographics":{"properties":{"address":{"$ref":"#/components/schemas/PatientAddress"},"dayOfBirth":{"type":"integer"},"gender":{"$ref":"#/components/schemas/PatientGender"},"healthId":{"example":"<username>@<suffix>","type":"string"},"healthIdNumber":{"example":"1111-1111-1111-11","type":"string"},"identifiers":{"items":{"$ref":"#/components/schemas/Identifier"},"type":"array","xml":{"name":"Identifiers","wrapped":true}},"monthOfBirth":{"type":"integer"},"name":{"example":"Jane Doe","type":"string"},"yearOfBirth":{"example":2000,"type":"integer"}},"required":["healthId","healthIdNumber","gender","name","yearOfBirth"],"type":"object"}},"required":["userDemographics"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request.","example":"499a5a4a-7dda-4f20-9b67-e24589627061","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","patient"],"type":"object","xml":{"name":"ShareProfileRequest"}},"ShareProfileResult":{"properties":{"acknowledgement":{"$ref":"#/components/schemas/ShareProfileAcknowledgement"},"error":{"$ref":"#/components/schemas/Error"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"resp":{"$ref":"#/components/schemas/RequestReference"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","acknowledgement","resp"],"type":"object","xml":{"name":"ShareProfileResult"}},"SubscriptionApprovalNotification":{"properties":{"notification":{"properties":{"status":{"$ref":"#/components/schemas/SubscriptionStatus"},"subscription":{"$ref":"#/components/schemas/HIUSubscription"},"subscriptionRequestId":{"example":"request id of the subscription","type":"string"}},"required":["status"],"type":"object"},"requestId":{"description":"a nonce, unique for each HTTP request","example":"5f7a535d-a3fd-416b-b069-c97d021fbacd","format":"uuid","type":"string"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","notification"],"type":"object"},"SubscriptionCategory":{"enum":["LINK"],"type":"string"},"SubscriptionPeriod":{"properties":{"from":{"format":"date-time","type":"string"},"to":{"format":"date-time","type":"string"}},"required":["from","to"],"type":"object"},"SubscriptionRequest":{"properties":{"requestId":{"description":"a nonce, unique for each HTTP request.","example":"499a5a4a-7dda-4f20-9b67-e24589627061","format":"uuid","type":"string"},"subscription":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/SubscriptionCategory"},"type":"array"},"hips":{"items":{"$ref":"#/components/schemas/OrganizationRepresentation"},"type":"array"},"hiu":{"$ref":"#/components/schemas/OrganizationRepresentation"},"patient":{"$ref":"#/components/schemas/ConsentManagerPatientID"},"period":{"$ref":"#/components/schemas/SubscriptionPeriod"},"purpose":{"$ref":"#/components/schemas/UsePurpose"}},"required":["purpose","patient","hiu","categories","period"],"type":"object"},"timestamp":{"$ref":"#/components/schemas/TimestampSchema"}},"required":["requestId","timestamp","subscription"],"type":"object"},"SubscriptionStatus":{"enum":["GRANTED","DENIED"],"type":"string"},"TimestampSchema":{"description":"Date time format in UTC, includes miliseconds YYYY-MM-DDThh:mm:ss.vZ","format":"date-time","type":"string"},"UsePurpose":{"properties":{"code":{"description":"From the fixed set, documented at refUri","type":"string"},"refUri":{"format":"uri","type":"string"},"text":{"type":"string"}},"required":["text","code"],"type":"object"},"UuidSchema":{"example":"a1s2c932-2f70-3ds3-a3b5-2sfd46b12a18d","format":"uuid","type":"string"},"consent":{"properties":{"id":{"type":"string"}},"required":["id"],"type":"object"},"dateRange":{"properties":{"from":{"format":"date-time","type":"string"},"to":{"format":"date-time","type":"string"}},"required":["from","to"],"type":"object"},"keyMaterial":{"properties":{"cryptoAlg":{"example":"ECDH","format":"string","type":"string"},"curve":{"example":"Curve25519","format":"string","type":"string"},"dhPublicKey":{"$ref":"#/components/schemas/keyObject"},"nonce":{"example":"3fa85f64-5717-4562-b3fc-2c963f66afa6","format":"32 byte string","type":"string"}},"required":["cryptoAlg","curve","dhPublicKey","nonce"],"type":"object"},"keyObject":{"properties":{"expiry":{"format":"date-time","type":"string"},"keyValue":{"format":"string","type":"string"},"parameters":{"example":"Curve25519/32byte random key","format":"string","type":"string"}},"required":["expiry","parameters","keyValue"],"type":"object"}}}}