Skip to content

List all organizations

get/v1/organizations

Returns a list of organizations that you currently belong to.

OAuth scopes

  • organizations:read

The fine-grained token must include the following permissions to access this endpoint:

  • organizations_read

Response codes

  • 200
  • 401
  • 403
  • 429
  • 500

Response (200)

[
  {
    "id": "lorem",
    "slug": "tsrqponmlkjihgfedcba",
    "name": "lorem"
  }
]
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Deprecated: Use `slug` instead.",
        "deprecated": true
      },
      "slug": {
        "type": "string",
        "pattern": "^[\\w-]+$",
        "description": "Organization slug",
        "example": "tsrqponmlkjihgfedcba"
      },
      "name": {
        "type": "string"
      }
    },
    "required": [
      "id",
      "slug",
      "name"
    ]
  }
}