Get an access request

GET/workspaces/{workspace}/access-requests/{accessRequest}

Returns one access request with the documents asked for, whether each was granted, and a short activity timeline.

Authentication

Send an API token as a bearer token. This endpoint needs a read token, made by any member of the workspace. Create one in My account → API tokens; see scopes and roles.

Authorization: Bearer 42|bynh_pat_•••••••Header

Path parameters

workspacestringRequired
Your workspace slug, e.g. dokan.
accessRequestintegerRequired
Access request id.

Response

200 OK

Request detail.

idintegerAccess request id.
companystringCompany.
requester{name, title, email}Who asked.
notestring|nullTheir note.
nda_signedbooleanSigned your NDA.
statusenumDecision state (use access_expires_at to tell if access has ended). One of pending, approved, declined.
access_expires_atstring|nullISO 8601.
access_daysintegerWorkspace setting: how long approved access lasts.
documents[]objectid, title, pages, visibility, visibility_label, granted.
activity[]{at, text}Localized timeline, oldest first.
created_atstringISO 8601.

Rate limits

This endpoint counts toward your general limit of 120 requests a minute. When you go over, wait for the number of seconds in Retry-After.

Errors

401The token is missing, wrong, revoked or expired.

404The token belongs to another workspace, or its owner is no longer a member. Or: No access request with that id in this workspace.

Every error is JSON with a message. See Errors.

Next →Approve an access request

curl "https://api.bynh.io/api/v1/workspaces/dokan/access-requests/1" \
  -H "Authorization: Bearer $BYNH_TOKEN" \
  -H "Accept: application/json"

Response200 OK

application/json

{
  "data": {
    "id": 88,
    "company": "Almarai Retail",
    "requester": {
      "name": "Noura Alsaud",
      "title": "Head of vendor risk",
      "email": "noura@almarai-retail.sa"
    },
    "note": "Annual supplier review.",
    "nda_signed": true,
    "status": "pending",
    "access_expires_at": null,
    "access_days": 30,
    "documents": [
      {
        "id": 412,
        "title": "ISO 27001 certificate 2025",
        "pages": 2,
        "visibility": "nda",
        "visibility_label": "Behind NDA",
        "granted": false
      },
      {
        "id": 415,
        "title": "SOC 2 Type II report",
        "pages": 64,
        "visibility": "nda",
        "visibility_label": "Behind NDA",
        "granted": false
      }
    ],
    "activity": [
      {
        "at": "2026-09-30T13:22:05+00:00",
        "text": "Request sent from trust.dokan.sa"
      },
      {
        "at": "2026-09-30T13:24:40+00:00",
        "text": "Mutual NDA signed · v2"
      }
    ],
    "created_at": "2026-09-30T13:22:05+00:00"
  }
}

Examples use Dokan, a sample workspace. Responses are shortened where lists are long.