Skip to content
bynhDocs

Export access requests as CSV

GET/workspaces/{workspace}/access/requests/export

Downloads every matching access request as CSV, newest first. The export is written to the audit log.

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.

Query parameters

  • statusenumdefault all

    Filter. One of all, waiting, approved, declined, ended.

  • qstring

    Search (max 120).

Response

200 OK

text/csv; charset=UTF-8 with BOM, Cache-Control: no-store, private; filename bynh-access-requests-{slug}-YYYY-MM-DD.csv. Columns: requested_at_utc, name, email, company, title, documents, reason, nda_version, nda_signed_at_utc, status, decided_by, decided_at_utc, access_until_utc. Always English. decided_by reads “Approved domain” for automatic approvals.

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.
422Bad status or q.

Every error is JSON with a message. See Errors.

Next →Get an access request
curl -OJ "https://api.bynh.io/api/v1/workspaces/dokan/access/requests/export?status=all" \
  -H "Authorization: Bearer $BYNH_TOKEN" \
  -H "Accept: application/json"

Response200 OK

File

The file itself, with its name in Content-Disposition.

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