Entities
Legal entities (organisations, trusts, LLCs) that users can act on behalf of. Distinct from Users — an entity has its own KYB record, wallets, and audit trail.
What you can do
- Create an entity and attach its controlling users
- Fetch entity metadata (jurisdiction, tax IDs, formation date)
- Link entity wallets and payment methods
- Query entity audit history for compliance review
Endpoints
GET
List entities, optionally filtered by user
/entities
POST
Create a new entity (e.g. a legal entity or fund)
/entities
GET
Get an entity by ID
/entities/{id}
GET
List users belonging to an entity
/entities/{id}/users
POST
Add a user to an entity
/entities/{id}/users
PUT
Update metadata for an entity
/entities/{id}/metadata
GET
List manual payment methods for an entity
/entities/{id}/manual-payment-methods
POST
Create a manual payment method for an entity
/entities/{id}/manual-payment-methods
GET
Get a specific manual payment method for an entity
/entities/{id}/manual-payment-methods/{methodId}
PATCH
Update a manual payment method for an entity
/entities/{id}/manual-payment-methods/{methodId}
GET
Get Astra business profile for an entity
/entities/{id}/astra
POST
Create an Astra business profile for an entity
/entities/{id}/astra
DELETE
Remove a user from an entity
/entities/{id}/users/{targetUserId}
POST
Grant a permission to a user within an entity
/entities/{id}/users/{targetUserId}/permissions
DELETE
Revoke a permission from a user within an entity
/entities/{entityId}/users/{targetUserId}/permissions/{permission}