Retrieve one of your entities, including your membership

GET

/my-entities/{id}

Fetches a single entity by its unique identifier and includes the authenticated identity's membership details for that entity (ownership status, role, and permissions). The authenticated identity must have an active resource-access record for the entity — either a wildcard * permission or the specific can_view_entity ACL flag. Attempting to fetch an entity you do not have access to returns a 403.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Responses

🟢200

application/json

The entity was found and returned successfully, together with the authenticated identity's membership on it.

Bodyapplication/json

🟠401

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/my-entities/01JABC1234567890ABCDEFGHIJ' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Entity owned by the authenticated identity

{
    "message": "Entity retrieved successfully",
    "status": "success",
    "data": {
        "id": "01JABC1234567890ABCDEFGHIJ",
        "parent_id": null,
        "name": "Acme Corp Nigeria",
        "client_reference": "ent-ng-001",
        "client_label": "Acme NG",
        "type": "business",
        "entity_logo": null,
        "category": "retail",
        "email": "contact@acmecorp.ng",
        "mobilenumber": "+2348012345678",
        "country": "NG",
        "status": "approved",
        "identity_id": "01JIDENT234567890ABCDEFGHI",
        "client_meta": {
            "crm_id": "crm-8821"
        },
        "membership": {
            "is_owner": true,
            "role": null,
            "role_name": "Owner",
            "permissions": [
                "*"
            ]
        }
    }
}

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

Create an entity sandbox session

List my entities