For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
GuidesAPI Reference
GuidesAPI Reference
  • API Reference
      • GETGet Current Organization
      • GETGet Organizations
      • POSTCreate Organization
      • GETGet Organization
      • PUTUpdate Organization
      • DELDelete Organization
Logo
Log inBook a demo
API ReferenceOrganization

Get Organizations

GET
https://app.polytomic.com/api/organizations
GET
/api/organizations
$curl https://app.polytomic.com/api/organizations \
>     -H "Authorization: Bearer <token>"
1{
2  "data": [
3    {
4      "id": "string",
5      "issuer": "https://example.com",
6      "name": "My Organization",
7      "sso_domain": "example.com",
8      "sso_org_id": "123456"
9    }
10  ]
11}
Lists every organization accessible to the calling partner, with the partner's owner organization first. In `2025-09-18`, this endpoint is partner-scoped rather than a general "current caller visibility" listing. The partner owner organization is returned first, followed by child organizations. This ordering matters for partner workflows such as shared connections, where the parent connection must live in the partner owner organization. If you need only the organization implied by the current credential, use [`GET /api/organization`](../../api-reference/organization/get-current) instead.
Was this page helpful?
Previous

Create Organization

Next

Lists every organization accessible to the calling partner, with the partner’s owner organization first.

In 2025-09-18, this endpoint is partner-scoped rather than a general “current caller visibility” listing. The partner owner organization is returned first, followed by child organizations.

This ordering matters for partner workflows such as shared connections, where the parent connection must live in the partner owner organization.

If you need only the organization implied by the current credential, use GET /api/organization instead.

Authentication

AuthorizationBearer
Bearer partner API key

Headers

X-Polytomic-VersionstringOptional

Response

OK
datalist of objects or null

Errors

500
Internal Server Error