List Your Organizations

GET /api/0/organizations/

Return a list of organizations available to the authenticated session in a region. This is particularly useful for requests with a user bound context. For API key-based requests this will only return the organization that belongs to the key.

Query Parameters:

owner (boolean)

Specify true to restrict results to organizations in which you are an owner.

cursor (string)

A pointer to the last object fetched and its sort order; used to retrieve the next or previous results.

query (string)

Filters results by using query syntax.

Valid query fields include:

  • id: The organization ID
  • slug: The organization slug
  • status: The organization's current status (one of active, pending_deletion, or deletion_in_progress)
  • email or member_id: Filter your organizations by the emails or organization member IDs of specific members included
  • platform: Filter your organizations to those with at least one project using this platform
  • query: Filter your organizations by name, slug, and members that contain this substring

Example: query=(slug:foo AND status:active) OR (email:[thing-one@example.com,thing-two@example.com] AND query:bar)

sortBy (string)

The field to sort results by, in descending order. If not specified the results are sorted by the date they were created.

Valid fields include:

  • members: By number of members
  • projects: By number of projects
  • events: By number of events in the past 24 hours

Scopes

<auth_token> requires one of the following scopes:
  • org:admin
  • org:read
  • org:write
Copied
curl https://sentry.io/api/0/organizations/ \
 -H 'Authorization: Bearer <auth_token>'
RESPONSESCHEMA
Copied
[
  {
    "avatar": {
      "avatarType": "letter_avatar",
      "avatarUuid": null
    },
    "dateCreated": "2018-11-06T21:19:55.101Z",
    "features": [
      "session-replay-video",
      "onboarding",
      "advanced-search",
      "monitor-seat-billing",
      "issue-platform"
    ],
    "hasAuthProvider": false,
    "id": "2",
    "isEarlyAdopter": false,
    "links": {
      "organizationUrl": "https://the-interstellar-jurisdiction.sentry.io",
      "regionUrl": "https://us.sentry.io"
    },
    "name": "The Interstellar Jurisdiction",
    "require2FA": false,
    "slug": "the-interstellar-jurisdiction",
    "status": {
      "id": "active",
      "name": "active"
    }
  }
]