# Organizations API

Retrieve the organizations accessible to the current API token.

Source: https://support.toolingmetrics.com/en/api/reference/organizations/
Updated: 2026-10-29

## Endpoint

```
GET /v1/organizations
```

Returns a map of organization names to IDs for all organizations accessible to the token bearer. Only organizations with an active subscription are included (unless the bearer is a super admin).

## Response

```json
{
  "Acme Manufacturing": 12,
  "Acme Tooling": 15
}
```

Use the numeric organization ID as the `:organization_id` path segment in all other API requests.

## Examples

```bash
curl https://api.toolingmetrics.com/v1/organizations \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```python
import requests

response = requests.get(
    "https://api.toolingmetrics.com/v1/organizations",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
response.raise_for_status()

orgs = response.json()
# {"Acme Manufacturing": 12, "Acme Tooling": 15}

# Get the ID for a specific organization by name
org_id = orgs["Acme Manufacturing"]
```

## Notes

- No `organization_id` path parameter is needed for this endpoint.
- The response lists only organizations where the token bearer has membership.
- Organizations with an inactive subscription are excluded.