---
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`

## Request

- Base URL: `https://sdk.nimbleway.com`
- URL: `https://sdk.nimbleway.com/v2/extract/templates/{extract_template_name}/versions`
- Auth: none declared

## 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.dev/nimbleway/apis/nimble-sdk.md) - [All operations](https://skmtc.dev/nimbleway/apis/nimble-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/nimbleway/apis/nimble-sdk/revisions/75720b84c9d7?raw)