Get membership
PlatformRetrieve membership details including tenant, role assignments, status and audit metadata.
Identity
One user identity
Membership
Tenant affiliation
Role
Functional access
Context
Tenant + membership
GET
/v1/memberships/{membership_id}Scope: memberships.readEndpoint summary
GET
/v1/memberships/{membership_id} requires memberships.read.Path parameters
| Name | Type | Description |
|---|---|---|
| membership_id | uuid | Membership identifier |
Example request
cURLCopy
GET https://api.mediloop.com/v1/memberships/mbr_456
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: tnt_123Example response
JSONCopy
{
"id": "mbr_456",
"user_id": "usr_123",
"tenant_id": "tnt_123",
"roles": ["doctor"],
"status": "active"
}Membership model
| Field | Type | Description |
|---|---|---|
| id | string | Immutable membership identifier |
| user_id | string | Mediloop user linked to the membership |
| tenant_id | string | Tenant in which access is granted |
| roles | string[] | Functional roles assigned to the membership |
| status | enum | invited, active, suspended, terminated |
| created_at | date-time | Membership creation timestamp |