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

# Get Entity

`GET /api/entities/{id}`

Returns a resolved entity by ID.

Looks up a UUID within the caller's current organization and returns the
resource type plus enough context to fetch the canonical resource.

This endpoint is useful when you have an execution, sync, model, connection,
organization, or user UUID and need to determine what it refers 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.

The response may also include:

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

For the normal user-scoped endpoint, `organization_id` is omitted from the
response.

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, or exists outside the caller's scoped
organization, 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

- `401` — Unauthorized
- `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/versions/b509e00e80aa/schema)