Get organizations

GET /api/organizations
OAuth2

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 is 1.

  • page_size integer

    Entries per page.

    Minimum value is 1. Default value is 20.

Responses

  • 200 application/json

    A list of organizations.

    Hide response attributes Show response attributes object
  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

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"
      }
    ]
  }
]