---
title: "Get Schema Status"
method: GET
path: "/api/connections/{id}/schemas/status"
tags: ["Schemas"]
---

# Get Schema Status

`GET /api/connections/{id}/schemas/status`

Returns the current schema inspection status for a connection.

Poll this endpoint after calling
[`POST /api/connections/{id}/schemas/refresh`](../../../../../api-reference/schemas/refresh) to track
progress. When `status` transitions to `completed`, the refreshed schemas
are available for use in sync configuration.

> 📘 Schema refresh is asynchronous
>
> This endpoint kicks off a background refresh of the connection's cached
> schemas and returns a `Location` header pointing at
> [`GET /api/connections/{id}/schemas/status`](../../../../../api-reference/schemas/get-status).
> Poll that endpoint until `cache_status` transitions from `refreshing` to
> `fresh` (or until `last_refresh_finished` advances past
> `last_refresh_started`) to observe completion.
>
> Only connections whose current health status is healthy may be refreshed.

## Path parameters

- `id` string, uuid, required — Unique identifier of the connection whose schema cache status should be returned.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- BulkSyncSourceStatusEnvelope
  - `data` BulkSyncSourceStatus
    - `cache_status` string
    - `last_refresh_finished` string, date-time, nullable
    - `last_refresh_started` string, date-time, nullable

## Other responses

- `400` — Bad Request
- `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)