Developers
V1MeClinicalAccess requestsRequestidDeny

Deny a pending clinical request

POST
/v1/me/clinical/access-requests/{requestId}/deny

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

requestId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Default{}

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/me/clinical/access-requests/497f6eca-6276-4993-bfeb-53cbbbba6f08/deny" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "status": "pending",  "practitioner": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "licenseAuthority": "string",    "licenseNumber": "string",    "specialistRegistration": "string",    "specialty": "string",    "organization": "string",    "verifiedAt": "2019-08-24T14:15:22Z",    "verificationValidUntil": "2019-08-24T14:15:22Z"  },  "requestedAt": "2019-08-24T14:15:22Z",  "pendingExpiresAt": "2019-08-24T14:15:22Z",  "approvedAt": "2019-08-24T14:15:22Z",  "expiresAt": "2019-08-24T14:15:22Z",  "deniedAt": "2019-08-24T14:15:22Z",  "revokedAt": "2019-08-24T14:15:22Z",  "purpose": "consultation_recordkeeping",  "scope": "read_and_add",  "noticeVersion": "2026-09-09"}

Approve this practitioner to read and add for this consultation POST

Requires explicit read-and-add consent to the displayed practitioner identity and notice. Defaults to 15 minutes, capped at one hour and the practitioner's credential expiry. Repeating approval never extends the grant.

Revoke clinical access POST

Next Page