---
title: "List your recent template creations and imports"
method: GET
path: "/instantiations"
tags: ["Templates"]
---

# List your recent template creations and imports

`GET /instantiations`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/instantiations`
- Auth: HTTP bearer

## Query parameters

- `group_id` integer, nullable
- `page` integer, nullable
- `per_page` integer, nullable
- `limit` integer, nullable

## Response `200`

Newest first, paginated

- InstantiationListResponse: Paginated list of instantiations.
  - `items` InstantiationResponse[], required
    - `created_at` string, date-time, required
    - `error` string, nullable: Why it failed, when it did.
    - `finished_at` string, date-time, nullable
    - `group_id` integer, nullable: The project the services go into, once known.
    - `id` integer, required
    - `kind` string, required: `template` or `import`.
    - `name` string, required
    - `services` InstantiatedService[], required
      - `name` string, required
      - `project_id` integer, nullable: Set once the service exists.
      - `slug` string, required
      - `template_service` string, required: Name of the service in the template.
    - `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'interrupted', required
    - `steps` InstantiationStep[], required
      - `error` string, nullable
      - `key` string, required: Stable identifier, such as `service:backend`.
      - `label` string, required: What the step does, for display.
      - `status` 'pending' | 'done' | 'failed', required
    - `template_slug` string, nullable
    - `updated_at` string, date-time, required
  - `page` integer, required
  - `per_page` integer, required
  - `total` integer, required

## Other responses

- `401`: Unauthorized

## Changes

> 77 revisions in range; 1 not diffed.

- **2026-10-14** `daf87435065e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gotempsh/apis/temps/changes/instantiations/get.md)

---

[API](https://skmtc.dev/gotempsh/apis/temps.md) · [All operations](https://skmtc.dev/gotempsh/apis/temps/llms.txt) · [OpenAPI document](https://skmtc.dev/gotempsh/apis/temps/revisions/24add76f6317?raw)