v77

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-045764591.5 MB

Organizations

✨ Seat report

<Card href="https://humansignal.com/goenterprise"> <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/> <p style="margin-top: 10px; font-size: 14px;"> This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise) </p> </Card> For each member of the organization: whether they occupy a standard (paid) seat, the effective organization role, what set that role, and every identity-provider group assignment behind it.

Only organization role assignments can put a user on a paid seat. Project role and workspace access assignments never affect the seat count.

Use ?email= to look up a single member, or ?has_stale_role_assignments=true to find members kept on a seat by leftover group assignments.

get/api/organizations/{id}/seat-report

Path parameters

idinteger required

Query parameters

counts_toward_seat_limitboolean

Only members who do (or do not) occupy a paid seat

emailstring

Exact email (case-insensitive)

has_stale_role_assignmentsboolean

Only members with orphaned/incomplete role assignments

include_seat_usageboolean

Adds a seat_usage object to the response envelope ({count, total, limit, reached, scope}, mirroring the billing counters). Off by default because it is a heavier count.

orderingstring

Which field to use when ordering the results.

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

role_sourcestring

Multiple values may be separated by commas. (comma-separated values)

searchstring

A search term.

Response

countinteger required

nextstring uri nullable

previousstring uri nullable

Example response

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}