Skip to content
bynhDocs
Log in

List evidence

GET/workspaces/{workspace}/evidence/items

Returns every piece of evidence, sorted by title, with its status, owner and counts.

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

  • qstring

    Searches title and category (max 100).

  • statusenum

    Only items with this status. One of current, due, overdue, pending.

Response

200 OK

Not paginated.

  • idintegerEvidence item id.
  • titlestringName.
  • categorystringOne of the categories listed on create.
  • statusenumpending: never collected. due: next review within 14 days. overdue: past next_review_at. One of current, due, overdue, pending.
  • status_labelstringLocalized (Current, Review due, Overdue, Not collected yet).
  • owner{id, name}|nullOwner.
  • review_every_daysenumCadence. One of 30, 90, 180, 365.
  • last_collected_atstring|nullISO 8601.
  • next_review_atstring|nullYYYY-MM-DD.
  • is_publicbooleanListed on the trust center.
  • requirements_countintegerMapped requirements.
  • files_countintegerAttached files.

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.
422q over 100 characters or unknown status.

Every error is JSON with a message. See Errors.

Next →Add evidence
curl "https://api.bynh.io/api/v1/workspaces/dokan/evidence/items?status=overdue" \
  -H "Authorization: Bearer $BYNH_TOKEN" \
  -H "Accept: application/json"

Response200 OK

application/json
{
  "data": [
    {
      "id": 31,
      "title": "Quarterly access review",
      "category": "Access management",
      "status": "current",
      "status_label": "Current",
      "owner": {
        "id": 21,
        "name": "Faisal Alharbi"
      },
      "review_every_days": 90,
      "last_collected_at": "2026-09-02T10:12:44+00:00",
      "next_review_at": "2026-12-01",
      "is_public": true,
      "requirements_count": 3,
      "files_count": 1
    },
    {
      "id": 35,
      "title": "Nightly database backup",
      "category": "Business continuity",
      "status": "overdue",
      "status_label": "Overdue",
      "owner": {
        "id": 21,
        "name": "Faisal Alharbi"
      },
      "review_every_days": 30,
      "last_collected_at": "2026-08-15T07:30:00+00:00",
      "next_review_at": "2026-09-14",
      "is_public": false,
      "requirements_count": 2,
      "files_count": 0
    }
  ]
}

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