Get organizations
Get organizations that match the given query with pagination.
Query parameters
-
q string
The query to filter organizations. It can be a partial ID or name.
If not provided, all organizations will be returned.
-
showFeatured string
Whether to show featured users in the organization. Featured users are randomly selected from the organization members.
If not provided,
featuredUsers
will not be included in the response. -
page integer
Page number (starts from 1).
Minimum value is
1
. Default value is1
. -
page_size integer
Entries per page.
Minimum value is
1
. Default value is20
.
GET /api/organizations
curl \
-X GET https://[tenant_id].logto.app/api/organizations \
-H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
[
{
"tenantId": "string",
"id": "string",
"name": "string",
"description": "string",
"customData": {},
"isMfaRequired": true,
"branding": {
"logoUrl": "string",
"darkLogoUrl": "string",
"favicon": "string",
"darkFavicon": "string"
},
"createdAt": 42.0,
"usersCount": 42.0,
"featuredUsers": [
{
"id": "string",
"avatar": "string",
"name": "string"
}
]
}
]