Skip to main content
Organization endpoints let you read org details, manage members, and list linked repositories. All organization endpoints are scoped under /api/0/organizations/{organization_id_or_slug}/.

Path parameters

organization_id_or_slug
string
required
The numeric ID or URL slug of the organization. You can find your org slug in the URL when you’re logged into Sentry: https://sentry.io/organizations/{slug}/.

Retrieve an organization

GET /api/0/organizations/{organization_id_or_slug}/
Returns details about a single organization. Required scope: org:read

Example request

curl https://sentry.io/api/0/organizations/my-org/ \
  -H "Authorization: Bearer sntrys_TOKEN"

Example response

{
  "id": "2",
  "slug": "my-org",
  "name": "My Organization",
  "dateCreated": "2018-11-06T21:19:55.101Z",
  "isEarlyAdopter": false,
  "features": ["discover-basic", "performance-view"],
  "status": {
    "id": "active",
    "name": "active"
  }
}

Response fields

id
string
The numeric ID of the organization, returned as a string.
slug
string
The URL-friendly slug for the organization.
name
string
The display name of the organization.
dateCreated
string
ISO 8601 timestamp of when the organization was created.
features
array
A list of feature flags enabled for the organization.
status
object
The organization’s current status.

List organization members

GET /api/0/organizations/{organization_id_or_slug}/members/
Returns a paginated list of members belonging to the organization. Required scope: member:read

Example request

curl https://sentry.io/api/0/organizations/my-org/members/ \
  -H "Authorization: Bearer sntrys_TOKEN"

Example response

[
  {
    "id": "1",
    "email": "jane@example.com",
    "name": "Jane Smith",
    "role": "member",
    "roleName": "Member",
    "pending": false,
    "dateCreated": "2019-03-22T10:00:00Z"
  }
]

Response fields

id
string
The member’s unique ID within the organization.
email
string
The member’s email address.
name
string
The member’s display name.
role
string
The member’s role identifier, e.g. "admin", "member", "owner".
pending
boolean
true if the member has been invited but not yet accepted.
dateCreated
string
ISO 8601 timestamp of when the member joined (or was invited to) the organization.

List organization repositories

GET /api/0/organizations/{organization_id_or_slug}/repos/
Returns a list of repositories linked to the organization. Repositories are used to associate commits with releases. Required scope: org:read

Example request

curl https://sentry.io/api/0/organizations/my-org/repos/ \
  -H "Authorization: Bearer sntrys_TOKEN"

Example response

[
  {
    "id": "4",
    "name": "my-org/my-repo",
    "url": "https://github.com/my-org/my-repo",
    "provider": {
      "id": "integrations:github",
      "name": "GitHub"
    },
    "status": "active",
    "dateCreated": "2019-05-01T00:00:00Z"
  }
]

Response fields

id
string
The repository’s unique ID.
name
string
The full repository name, typically "owner/repo".
url
string
The URL to the repository on the source control provider.
provider
object
The source control provider integration.
status
string
The sync status of the repository, e.g. "active", "disabled".