CapableDocs

Search the API docs

Find an endpoint or guide

Get an API key

StakeholdersList stakeholders

Stakeholders

List stakeholders

Every person and entity on the register, with relationship, status and your own external id.
GET/api/v1/stakeholders

Requires an API key with the stakeholders:read scope · How keys work

Response 200

Every stakeholder in one response, under data.

  • dataobject[]

    The stakeholders.

    ›Show 13 attributes
    • idstring

      Unique id.

    • namestring

      Full name of the person or the institution.

    • emailstring | null

      Email address, lower case.

    • typestring

      A person or an entity.

      One ofindividualinstitution

    • relationshipstring

      How the stakeholder relates to the company.

      One offounderemployeeformer_employeeinvestoradvisorconsultantboard_memberother

    • relationshipLabelstring

      The relationship as shown in the app, such as Former employee.

    • titlestring | null

      Job title.

    • statusstring

      Terminated once a termination is recorded.

      One ofactiveterminated

    • startDatedate | null

      Start date, YYYY-MM-DD.

    • terminationDatedate | null

      Termination date, YYYY-MM-DD.

    • lastDateToExercisedate | null

      Last day to exercise vested options after termination.

    • externalIdstring | null

      Your own id for this person, such as an HRIS employee id.

    • createdAttimestamp

      When the record was created, ISO 8601 in UTC.

Example

Request
curl https://capable.so/api/v1/stakeholders \
  -H "Authorization: Bearer $CAPABLE_API_KEY"
Response · 200 OK
JSON
{
  "data": [
    {
      "id": "stk_4m8q2xw7ka1p",
      "name": "Priya Raman",
      "email": "priya@northwind.ai",
      "type": "individual",
      "relationship": "employee",
      "relationshipLabel": "Employee",
      "title": "Founding engineer",
      "status": "active",
      "startDate": "2025-03-03",
      "terminationDate": null,
      "lastDateToExercise": null,
      "externalId": "rippling-0142",
      "createdAt": "2025-03-04T17:21:09.000Z"
    }
  ]
}

Errors

StatusWhen
401 UnauthorizedThe key is missing, invalid or revoked, or its creator lost access.
402 Payment requiredThe company has no active plan in good standing: its trial ended without one, a payment has failed for over 21 days, or its subscription is paused or has ended.
403 ForbiddenThe key does not have the stakeholders:read scope.
429 Too many requestsThe key went over its rate limit. Wait for Retry-After seconds.

Every error has the same shape. See Errors, limits and conventions.