v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB
Organizations

Get a list of organizations for an instance

This request returns the list of organizations for an instance. Results can be paginated using the optional limit and offset query parameters. The organizations are ordered by descending creation date. Most recent organizations will be returned first.

get/organizations

Query parameters

include_members_countboolean

Flag to denote whether the member counts of each organization should be included in the response or not.

include_missing_member_with_elevated_permissionsboolean

Flag to denote whether or not to include a member with elevated permissions who is not currently a member of the organization.

querystring

Returns organizations with ID, name, or slug that match the given query. Uses exact match for organization ID and partial match for name and slug.

user_idstring[]

Returns organizations that include any of the specified user IDs as members. Any user IDs not found are ignored. For each user ID, the + and - can be prepended to the ID, which denote whether the respective organization should be included or excluded from the result set.

organization_idstring[]

Returns organizations with the organization IDs specified. Any organization IDs not found are ignored. For each organization ID, the + and - can be prepended to the ID, which denote whether the respective organization should be included or excluded from the result set. Accepts up to 100 organization IDs. Example: ?organization_id=+org_1&organization_id=-org_2

order_bystring

Allows to return organizations in a particular order. At the moment, you can order the returned organizations either by their name, created_at or members_count. In order to specify the direction, you can use the +/- symbols prepended in the property to order by. For example, if you want organizations to be returned in descending order according to their created_at property, you can use -created_at. If you don't use + or -, then + is implied. Defaults to -created_at.

limitinteger

Applies a limit to the number of results returned. Can be used for paginating the results together with offset.

offsetinteger

Skip the first offset results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with limit.

Response

A list of organizations

total_countinteger required

Total number of organizations