---
title: "GET /registry/{asset}/{namespace}/{slug}/instances"
method: GET
path: "/registry/{asset}/{namespace}/{slug}/instances"
tags: ["api-docs"]
---

# GET /registry/{asset}/{namespace}/{slug}/instances

`GET /registry/{asset}/{namespace}/{slug}/instances`

Content instances for a registry document, newest first

## Path parameters

- `asset` 'apis' | 'schemas' | 'rules', required
- `namespace` string, required
- `slug` string, required

## Query parameters

- `version` string
- `page` integer, required
- `perPage` integer, required

## Response `200`

Default Response

- object
  - `instances` DocInstance[], required
    - `uid` string, required
    - `createdAt` integer, required
    - `updatedAt` integer, required
    - `version` string, required
    - `jsonSha` string, required
    - `yamlSha` string, required
    - `uploadedBy` string, nullable, required
    - `source` 'manual' | 'cli' | 'api' | 'git-sync' | 'url-sync' | 'migration', required
    - `origin` union, required
      - object
        - `type` 'platform', required
      - object
        - `type` 'git', required
        - `commitSha` string, nullable, required
        - `branch` string, nullable, required
        - `draft` object, nullable, required
          - `prNumber` number, required
          - `branch` string, required
          - `resolution` 'merged' | 'closed', nullable, required
      - object
        - `type` 'url', required
        - `url` string, uri, required
    - `message` string, required
    - `parentInstanceUid` string, required
    - `mergeParentUid` string, required
    - `revertOf` string, required
    - `servable` boolean, required
  - `tracked` boolean, required

## Other responses

- `400` — Bad request
- `401` — No auth
- `403` — Forbidden
- `404` — Not found
- `422` — Invalid payload
- `500` — Uncaught error

## Changes

- **2026-08-29** `3095882242e8` — 2 info
  - added the required property `instances/items/revertOf` to the response with the `200` status
  - added the required property `instances/items/servable` to the response with the `200` status
- **2026-08-21** `4efa9fcf5c1e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/scalar/apis/core/changes/registry/:asset/:namespace/:slug/instances/get.md)

---

[API](https://skmtc.dev/scalar/apis/core.md) · [All operations](https://skmtc.dev/scalar/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scalar/core/revisions/82f9494f4fbd/schema)