List an entity's team members

GET

/entity-access

Returns the members (identities) that have been granted access to a given entity, including the entity's owner. Each item reports the member's identity details, whether they are the entity's owner, and their assigned role.

The caller must themselves have an active access record on the entity with the can_list_entity_members permission (or the wildcard * permission); otherwise the request is rejected.

Results are sorted by access record creation date, newest first, and the response includes a meta.pagination block. Note: the page size is currently fixed at 50 records per request — the endpoint does not yet accept cursor or limit query parameters to page through results beyond the first 50.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

The entity's members were found and returned successfully. If the entity has no members other than its owner, data still includes at least the owner's record.

Bodyapplication/json

🟠400

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location '/entity-access?entity_id=01HZ9ABCD1234EFGH5678IJKL90' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Entity with an owner and additional members

{
    "message": "Entity access list retrieved successfully",
    "status": "success",
    "data": [
        {
            "id": "01HZAAOWNER0000000000000A",
            "identity_id": "01HZ9OWNER1234EFGH5678IJKL",
            "name": "Jane Doe",
            "email": "jane.doe@example.com",
            "status": "active",
            "is_owner": true,
            "role": null
        },
        {
            "id": "01HZAABBCCDDEEFFGGHHJJKKMM",
            "identity_id": "01HZ9KPQR3VTXMN84JWYB65CD0",
            "name": "John Smith",
            "email": "john.smith@example.com",
            "status": "active",
            "is_owner": false,
            "role": "finance"
        }
    ],
    "meta": {
        "pagination": {
            "cursor": null,
            "has_more": false
        }
    }
}

Modified at 2026-09-30 00:29:30

Remove a member's access to an entity

Accept an entity access invitation