Evidence

What the workspace knows about a record, and where it came from.

#List evidence on a record

GET/api/v1/evidence

Operation list_evidence · needs scope evidence:read

Newest first. Private evidence is never returned; metadata-only evidence has title and content null.

ParameterInTypeNotes
record_type requiredqueryperson | company | lead | opportunity
record_id requiredquerystring
kindsquerystringComma-separated evidence kinds.
limitqueryintegerPage size, at most 100.
cursorquerystringpagination.nextCursor from the previous page.
bash
curl https://synconone.com/api/v1/evidence?record_type=person&record_id=pr_1a2b3c4d5e6f7a8b \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
json
{
  "data": [
    {
      "id": "pr_1a2b3c4d5e6f7a8b",
      "object": "string",
      "kind": "string",
      "source": "string",
      "provider": "string",
      "occurred_at": "2026-11-05T10:00:00Z",
      "actor_kind": "string",
      "actor_label": "string",
      "title": "Annual plan renewal",
      "content": "string"
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false
  }
}

Errors: 401: Missing, invalid, revoked or expired API key. · 403: The key lacks the scope, or its role cannot do this. · 422: Validation failed. · 429: Rate limited. Honour Retry-After.. See errors.

#Get one piece of evidence

GET/api/v1/evidence/{id}

Operation get_evidence · needs scope evidence:read

ParameterInTypeNotes
id requiredpathstringEvidence id.
bash
curl https://synconone.com/api/v1/evidence/pr_1a2b3c4d5e6f7a8b \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
json
{
  "data": {
    "id": "pr_1a2b3c4d5e6f7a8b",
    "object": "string",
    "kind": "string",
    "source": "string",
    "provider": "string",
    "occurred_at": "2026-11-05T10:00:00Z",
    "actor_kind": "string",
    "actor_label": "string",
    "title": "Annual plan renewal",
    "content": "string"
  }
}

Errors: 401: Missing, invalid, revoked or expired API key. · 403: The key lacks the scope, or its role cannot do this. · 404: Not found, or not visible to this key. · 422: Validation failed. · 429: Rate limited. Honour Retry-After.. See errors.