For AI agents: the documentation index is at /docs/aidbox/llms.txt. A Markdown version of this page is available at /docs/aidbox/modules/eprescription/epcs/access-management/list-permissions.md or by requesting it with the Accept: text/markdown header.
Aidbox Docs

List Permissions

Access permissions come from bootstrapping the first administrator and from approved access-change requests. A revocation deletes the permission, so a listing shows only the permissions in force. Without an acting user, both listings return 403.

List Your Own Permissions

GET /e-prescription/access/epcs/permissions/mine

200 OK returns a searchset Bundle with the acting user's access permissions at every location.

List Permissions at the Locations You Administer

GET /e-prescription/access/epcs/permissions
GET /e-prescription/access/epcs/permissions?location=<Location id>

Example 200 OK response for a location the acting user administers:

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "resource": {
        "resourceType": "EPrescriptionAccessPermission",
        "id": "9f1c1a2e-4d5b-4b1a-9c1e-2f6d0e7a8b90",
        "permissionCode": "epcs-access-admin",
        "user": { "reference": "User/first-admin" },
        "location": { "reference": "Location/clinic-1" },
        "grantedAt": "2026-09-29T09:00:00Z"
      }
    }
  ]
}

permissionCode can be one of:

  • epcs-access-admin for the administrator access manager role
  • epcs-access-approver for the approver access manager role
  • epcs-prescribing for the EPCS prescribing permission

The optional location parameter limits the result to one location.

Administrators can list other users' permissions at their locations.

Last updated: