> ## Documentation Index
> Fetch the complete documentation index at: https://sentrydocs.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations

> Manage organizations, members, and settings via the API

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

<ParamField path="organization_id_or_slug" type="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}/`.
</ParamField>

***

## Retrieve an organization

```
GET /api/0/organizations/{organization_id_or_slug}/
```

Returns details about a single organization.

**Required scope:** `org:read`

### Example request

```bash theme={null}
curl https://sentry.io/api/0/organizations/my-org/ \
  -H "Authorization: Bearer sntrys_TOKEN"
```

### Example response

```json theme={null}
{
  "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

<ResponseField name="id" type="string">
  The numeric ID of the organization, returned as a string.
</ResponseField>

<ResponseField name="slug" type="string">
  The URL-friendly slug for the organization.
</ResponseField>

<ResponseField name="name" type="string">
  The display name of the organization.
</ResponseField>

<ResponseField name="dateCreated" type="string">
  ISO 8601 timestamp of when the organization was created.
</ResponseField>

<ResponseField name="features" type="array">
  A list of feature flags enabled for the organization.
</ResponseField>

<ResponseField name="status" type="object">
  The organization's current status.

  <Expandable title="status fields">
    <ResponseField name="id" type="string">
      The status identifier, e.g. `"active"`.
    </ResponseField>

    <ResponseField name="name" type="string">
      The human-readable status name.
    </ResponseField>
  </Expandable>
</ResponseField>

***

## 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

```bash theme={null}
curl https://sentry.io/api/0/organizations/my-org/members/ \
  -H "Authorization: Bearer sntrys_TOKEN"
```

### Example response

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

### Response fields

<ResponseField name="id" type="string">
  The member's unique ID within the organization.
</ResponseField>

<ResponseField name="email" type="string">
  The member's email address.
</ResponseField>

<ResponseField name="name" type="string">
  The member's display name.
</ResponseField>

<ResponseField name="role" type="string">
  The member's role identifier, e.g. `"admin"`, `"member"`, `"owner"`.
</ResponseField>

<ResponseField name="pending" type="boolean">
  `true` if the member has been invited but not yet accepted.
</ResponseField>

<ResponseField name="dateCreated" type="string">
  ISO 8601 timestamp of when the member joined (or was invited to) the organization.
</ResponseField>

***

## 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

```bash theme={null}
curl https://sentry.io/api/0/organizations/my-org/repos/ \
  -H "Authorization: Bearer sntrys_TOKEN"
```

### Example response

```json theme={null}
[
  {
    "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

<ResponseField name="id" type="string">
  The repository's unique ID.
</ResponseField>

<ResponseField name="name" type="string">
  The full repository name, typically `"owner/repo"`.
</ResponseField>

<ResponseField name="url" type="string">
  The URL to the repository on the source control provider.
</ResponseField>

<ResponseField name="provider" type="object">
  The source control provider integration.

  <Expandable title="provider fields">
    <ResponseField name="id" type="string">
      The provider identifier, e.g. `"integrations:github"`.
    </ResponseField>

    <ResponseField name="name" type="string">
      The human-readable provider name.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string">
  The sync status of the repository, e.g. `"active"`, `"disabled"`.
</ResponseField>