API reference · Organizations
org management customers list
GET
/v1/orgs/{org}/management/customers- Permission
authenticated: any signed-in caller or API token- Operation
org.management.customers.list
Parameters
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
org | path | string | yes | for example "org_01h455vb4pex5vsknk084sn02q" |
limit | query | integer | no | 1 to 100; default 50 |
cursor | query | string | no | for example "mlink_01h455vb4pex5vsknk084sn02q" |
x-obhut-management-assignment | header | string | no | Select one staff assignment. Direct membership remains the default. Bound API tokens use their stored source and ignore this selector. For example "masg_01h455vb4pex5vsknk084sn02q" |
Response 200
| Field | Type | Required | Notes |
|---|---|---|---|
items | array of object | yes | |
items[].customer | object | yes | |
items[].customer.id | string | yes | for example "org_01h455vb4pex5vsknk084sn02q" |
items[].customer.name | string | yes | |
items[].link | object | yes | |
items[].link.id | string | yes | for example "mlink_01h455vb4pex5vsknk084sn02q" |
items[].link.customerOrgId | string | yes | for example "org_01h455vb4pex5vsknk084sn02q" |
items[].link.providerOrgId | string | yes | for example "org_01h455vb4pex5vsknk084sn02q" |
items[].link.offerId | string | yes | for example "moffer_01h455vb4pex5vsknk084sn02q" |
items[].link.permissions | array of string | yes | 1 to 100 items |
items[].link.revision | string | yes | Opaque revision: dot-joined counters. |
items[].link.approvedBy | string | yes | for example "user_01h455vb4pex5vsknk084sn02q" |
items[].link.approvedAt | string (date-time) | yes | UTC, ISO 8601. |
items[].link.endedAt | string (date-time) or null | yes | |
items[].link.endedBy | string or null | yes | |
items[].link.endReason | string or null | yes | |
items[].link.handoverReview | object or null | yes | |
items[].link.handoverReview.completed | array of string | yes | 0 to 5 items |
items[].link.handoverReview.reviewedAt | string (date-time) | yes | UTC, ISO 8601. |
items[].link.handoverReview.reviewedBy | string or null | yes | |
items[].assignments | array of object | yes | |
items[].assignments[].assignmentId | string | yes | for example "masg_01h455vb4pex5vsknk084sn02q" |
items[].assignments[].linkId | string | yes | for example "mlink_01h455vb4pex5vsknk084sn02q" |
items[].assignments[].providerOrgId | string | yes | for example "org_01h455vb4pex5vsknk084sn02q" |
items[].assignments[].customerOrgId | string | yes | for example "org_01h455vb4pex5vsknk084sn02q" |
items[].assignments[].userId | string | yes | for example "user_01h455vb4pex5vsknk084sn02q" |
items[].assignments[].permissions | array of string | yes | 1 to 100 items |
items[].assignments[].createdAt | string (date-time) | yes | UTC, ISO 8601. |
nextCursor | string or null | yes |