List stakeholders

You can retrieve all stakeholders associated with a verification using the GET endpoint. This is useful for displaying stakeholder status to users, tracking verification progress, or for auditing purposes.

GET/v5/verifications/:trace/stakeholders

List all stakeholders

This endpoint returns summary data for all stakeholders associated with a verification. Each stakeholder summary includes their role, entity type, name, and timestamps.

This endpoint returns lightweight summary data for efficient listing. For full stakeholder details (including complete entity data), use the Get a specific stakeholder endpoint.

Path parameters

Name
trace
Type
string
Description
The unique identifier for the verification (received when creating the verification).

Response fields

The response contains a data.stakeholders array. Each stakeholder summary includes:

Field	Type	Description
`stakeholderId`	string	Unique stakeholder identifier.
`role`	string	The stakeholder's role (e.g., `trustee`, `director`, `beneficiary`).
`type`	string	Entity type (`individual`, `company`, `trust`, etc.).
`subType`	string	Entity sub-type (e.g., `discretionaryTrust`, `none`).
`country`	string	ISO3 country code.
`name`	string	Display name (full name for individuals, entity name for companies).
`createdAt`	number	Unix timestamp of creation.
`updatedAt`	number	Unix timestamp of last update.
`createdTime`	string	Human-readable creation time.
`updatedTime`	string	Human-readable update time.

Request

GET

/v5/verifications/:trace/stakeholders

curl https://dev.bronid.com/v5/verifications/abc123-verification-trace/stakeholders \
  --user "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2:api_sec_NJAtNcRtUrPlf7xYDrMNP9URI-ZfN314"

Response

{
  "timestamp": "2026-01-30T04:00:00.000Z",
  "serviceUid": "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2",
  "trace": "abc123-verification-trace",
  "path": "/v5/verifications/:trace/stakeholders",
  "pathParams": {
    "trace": "abc123-verification-trace"
  },
  "statusCode": 200,
  "message": "Stakeholders listed successfully.",
  "help": null,
  "status": "success",
  "data": {
    "stakeholders": [
      {
        "stakeholderId": "stk-id-123",
        "role": "trustee",
        "type": "company",
        "subType": "none",
        "country": "AUS",
        "name": "Smith Trustee Pty Ltd",
        "createdAt": 1737254548899,
        "updatedAt": 1737254548899,
        "createdTime": "30/01/2026 14:00:00",
        "updatedTime": "30/01/2026 14:00:00"
      },
      {
        "stakeholderId": "stk-id-456",
        "role": "director",
        "type": "individual",
        "subType": "none",
        "country": "AUS",
        "name": "John Smith",
        "createdAt": 1737254600000,
        "updatedAt": 1737254600000,
        "createdTime": "30/01/2026 14:05:00",
        "updatedTime": "30/01/2026 14:05:00"
      }
    ]
  },
  "error": null
}

GET/v5/verifications/:trace/stakeholders/:stakeholderId

Get a specific stakeholder

To retrieve full details about a specific stakeholder, use the stakeholder ID in the path. This returns the complete stakeholder data including all entity details, identifiers, and addresses.

Path parameters

Name
trace
Type
string
Description
The unique identifier for the verification.
Name
stakeholderId
Type
string
Description
The unique identifier for the stakeholder (from the list response).

Response fields

The response contains the full stakeholder data at data:

Field	Type	Description
`stakeholderId`	string	Unique stakeholder identifier.
`role`	string	The stakeholder's role.
`type`	string	Entity type (`individual`, `company`, etc.).
`subType`	string	Entity sub-type.
`country`	string	ISO3 country code.
`firstName`	string	First name (for individuals).
`lastName`	string	Last name (for individuals).
`name`	string	Entity name (for companies/trusts).
`email`	string	Contact email.
`identifiers`	object	Entity identifiers (ABN, ACN, etc.).
`addresses`	object	Entity addresses.
`submissionId`	string	Reference to the submission that created this stakeholder.
`createdAt`	number	Unix timestamp of creation.
`updatedAt`	number	Unix timestamp of last update.
`createdTime`	string	Human-readable creation time.
`updatedTime`	string	Human-readable update time.

Error responses

Status Code	Error Type	Description
404	`not_found`	Stakeholder not found for the given verification.

Request

GET

/v5/verifications/:trace/stakeholders/:stakeholderId

curl https://dev.bronid.com/v5/verifications/abc123-verification-trace/stakeholders/stk-id-123 \
  --user "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2:api_sec_NJAtNcRtUrPlf7xYDrMNP9URI-ZfN314"

Response

{
  "timestamp": "2026-01-30T04:05:00.000Z",
  "serviceUid": "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2",
  "trace": "abc123-verification-trace",
  "path": "/v5/verifications/:trace/stakeholders/:stakeholderId",
  "pathParams": {
    "trace": "abc123-verification-trace",
    "stakeholderId": "stk-id-123"
  },
  "statusCode": 200,
  "message": "Stakeholder details retrieved successfully.",
  "help": null,
  "status": "success",
  "data": {
    "stakeholderId": "stk-id-123",
    "role": "trustee",
    "type": "company",
    "subType": "none",
    "country": "AUS",
    "name": "Smith Trustee Pty Ltd",
    "industry": "Trustee Services",
    "website": "https://smithtrustee.com.au",
    "identifiers": {
      "acn": "123456789",
      "abn": "98765432101"
    },
    "addresses": {
      "registeredAddress": "Level 5, 100 Collins St, Melbourne VIC 3000",
      "principalPlaceOfBusiness": "Suite 10, 50 Bridge St, Sydney NSW 2000"
    },
    "submissionId": "sub-abc123",
    "createdAt": 1737254548899,
    "updatedAt": 1737254548899,
    "createdTime": "30/01/2026 14:00:00",
    "updatedTime": "30/01/2026 14:00:00"
  },
  "error": null
}

Error response (404)

{
  "timestamp": "2026-01-30T04:05:00.000Z",
  "serviceUid": "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2",
  "trace": "abc123-verification-trace",
  "path": "/v5/verifications/:trace/stakeholders/:stakeholderId",
  "pathParams": {
    "trace": "abc123-verification-trace",
    "stakeholderId": "invalid-stakeholder-id"
  },
  "statusCode": 404,
  "message": "Not found",
  "help": null,
  "status": "error",
  "data": null,
  "error": {
    "type": "not_found",
    "details": [
      {
        "message": "Stakeholder not found",
        "code": "not_found",
        "path": ["stakeholderId"]
      }
    ]
  }
}

Stakeholder roles

Stakeholders can have one of the following roles:

Role	Description
`applicant`	The primary applicant or contact person for the verification.
`director`	A director of the company or organization being verified.
`trustee`	A trustee of a trust entity.
`settlor`	The settlor or creator of a trust.
`beneficiary`	A beneficiary of a trust.
`shareholder`	A shareholder or owner of the entity.
`partner`	A partner in a partnership entity.
`other`	Any other stakeholder type not covered above.

What's next?

Now that you know how to list and retrieve stakeholders, explore Include stakeholders to learn how to add stakeholders when creating a verification, or see the full Stakeholders API reference for updating stakeholder requests.