---
title: "List Extract Template Versions"
method: GET
path: "/v2/extract/templates/{extract_template_name}/versions"
tags: ["Extract Templates API"]
---

# List Extract Template Versions

`GET /v2/extract/templates/{extract_template_name}/versions`

## Path parameters

- `extract_template_name` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- ListResponseExtractTemplateVersionResponsePublicV2
  - `items` ExtractTemplateVersionResponsePublicV2[], required — Items returned in this page.
    - `created_at` string, date-time, required — When the version was created.
    - `id` string, uuid, required — Unique extract template version identifier.
    - `input_schema` object, required — JSON schema describing accepted input parameters.
    - `metadata` ExtractTemplateVersionMetadataPublicV2, required
      - `data_source` string, nullable — Data source associated with the version.
      - `description` string, nullable — Version description shown to users.
      - `display_name` string, nullable — Human-friendly version display name.
      - `domain` string, nullable — Domain associated with the version.
      - `entity_type` string, nullable — Entity type produced by the version.
      - `tags` string[] — Tags associated with the version.
      - `vertical` string, nullable — Business vertical associated with the version.
    - `name` string, required — Extract template name this version belongs to.
    - `output_schema` object, required — JSON schema describing extracted output.
    - `samples` ExtractTemplateSamplePublicV2[], nullable — Sample input and output pairs for the version.
      - `input` unknown
      - `output` unknown
    - `version_number` integer, required — Monotonic version number for the extract template.
  - `limit` integer, required — Maximum number of items returned.
  - `offset` integer, required — Number of items skipped before this page.
  - `total` integer, required — Total number of items matching the query.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nimbleway/apis/nimble-sdk.md) · [All operations](https://skmtc.net/nimbleway/apis/nimble-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nimbleway/nimble-sdk/versions/725be79e7005/schema)