Skip to content
Tooling Metrics Support
Select language:English
Select theme

Organizations API

Retrieve the organizations accessible to the current API token.

Updated

Endpoint

Section titled “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

Section titled “Response”
{
  "Acme Manufacturing": 12,
  "Acme Tooling": 15
}

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

Examples

Section titled “Examples”
curl https://api.toolingmetrics.com/v1/organizations \
  -H "Authorization: Bearer YOUR_TOKEN"
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

Section titled “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.

© 2026 ToolingMetrics. All rights reserved.