---
title: "Get Partner Entity"
method: GET
path: "/api/organizations/entities/{id}"
tags: ["Entities"]
---

# Get Partner Entity

`GET /api/organizations/entities/{id}`

Returns a resolved entity by ID within a partner organization scope.

Looks up a UUID across organizations using partner authentication and returns
the resource type plus enough context to fetch the canonical resource.

This endpoint is intended for cross-organization partner workflows where the
caller has an arbitrary UUID and needs to discover both the resource type and
the organization it belongs to.

The response always includes:

- `id`: the UUID that was resolved.
- `type`: the resolved entity type.
- `canonical_path`: the canonical REST path for the resolved resource.
- `organization_id`: the organization that owns the resolved resource.

The response may also include:

- `relationships`: parent resources needed to address nested resources.
- `context`: lightweight additional context, such as bulk sync `schema_ids`.

Supported `type` values currently include:

- `organization`
- `user`
- `connection`
- `model`
- `sync`
- `sync_execution`
- `bulk_sync`
- `bulk_sync_execution`

Examples:

- A model sync execution resolves to a `sync_execution` and includes a `sync`
  relationship.
- A bulk sync execution resolves to a `bulk_sync_execution`, includes a
  `bulk_sync` relationship, and may include `context.schema_ids`.

If the UUID does not exist, the endpoint returns `404`.

## Path parameters

- `id` string, uuid, required — UUID of the entity to resolve.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- EntityResponseEnvelope
  - `data` EntityResponse
    - `canonical_path` string — Canonical REST path for the resolved resource, suitable for fetching it directly.
    - `context` object — Lightweight additional context about the resolved entity, such as bulk sync schema_ids.
    - `id` string, uuid — UUID that was resolved.
    - `organization_id` string, uuid — Organization that owns the resolved resource. Omitted from responses on the user-scoped endpoint.
    - `relationships` object — Parent resources needed to address nested resources, keyed by relationship name (e.g. "sync", "bulk_sync").
    - `type` string — Resolved entity type. One of: organization, user, connection, model, sync, sync_execution, bulk_sync, bulk_sync_execution.

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/revisions/31d9a913d396/schema)