Get evidence
GET
/workspaces/{workspace}/evidence/items/{evidenceItem}Returns one piece of evidence with its requirements (and whether each is met), files, a 90-day timeline, recent history and the people who can own it.
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_•••••••HeaderPath parameters
workspacestringRequiredYour workspace slug, e.g. dokan.
evidenceItemintegerRequiredEvidence item id.
Response
200 OKFull item plus people (id, name, role of members who can edit).
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 ofcurrent,due,overdue,pending.status_labelstringLocalized (Current, Review due, Overdue, Not collected yet).owner{id, name}|nullOwner.review_every_daysenumCadence. One of30,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.descriptionstring|nullLonger description.methodstring|nullHow it’s collected.public_labelstring|nullLabel shown publicly.reminded_atstring|nullLast reminder.created_atstringISO 8601.requirements[]objectid, code, title, framework {slug, short_name}; on GET show alsomet.files[]objectid, filename, mime, size, uploaded_by, uploaded_at, download_path.timelineobjectdays (90 strings, oldest first: current | overdue | none), current_share (percent of tracked days current, 1 decimal, or null), collections (count in the last 90 days), lapse (most recent overdue run: from, to, days, ongoing, resolved_by, note; or null).history[]objectLast 40 audit events on the item: id, kind (action without the evidence. prefix), who, text (localized), at.people[]{id, name, role}Members who can own evidence.
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 evidence item with that id in this workspace.
Every error is JSON with a message. See Errors.