> ## Documentation Index
> Fetch the complete documentation index at: https://docs.junction.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Lab Test Version History

> List the immutable marker-set versions for a lab test via the Junction API. Requires authentication with your team API key.

Returns the marker set recorded for each version of a lab test, ordered as a paginated history.

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
       --url '{{BASE_URL}}/v3/lab_tests/<lab_test_id>/version?size=50' \
       --header 'accept: application/json' \
       --header 'x-vital-api-key: YOUR_API_KEY'
  ```
</RequestExample>


## OpenAPI

````yaml GET /v3/lab_tests/{lab_test_id}/version
openapi: 3.1.0
info:
  title: Junction API
  description: https://docs.junction.com/
  version: 0.4.919
servers:
  - url: https://api.us.junction.com
    x-fern-server-name: Production
  - url: https://api.eu.junction.com
    x-fern-server-name: ProductionEU
  - url: https://api.sandbox.us.junction.com
    x-fern-server-name: Sandbox
  - url: https://api.sandbox.eu.junction.com
    x-fern-server-name: SandboxEU
security:
  - apiKeyAuth: []
paths:
  /v3/lab_tests/{lab_test_id}/version:
    get:
      tags:
        - lab_tests
      summary: Get Lab Test Version History
      description: >-
        List immutable marker-set versions under the established lab-tests
        resource.
      operationId: get_lab_test_version_history_v3_lab_tests__lab_test_id__version_get
      parameters:
        - name: lab_test_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: The identifier Vital assigned to a lab test.
        - name: next_cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                pattern: ^[1-9]\d*$
              - type: 'null'
            title: Next Cursor
        - name: size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 50
            title: Size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetLabTestVersionHistoryResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    GetLabTestVersionHistoryResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/LabTestVersionSummary'
          type: array
          title: Data
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      type: object
      required:
        - data
        - next_cursor
      title: GetLabTestVersionHistoryResponse
    HTTPValidationError:
      properties:
        detail:
          title: Detail
      type: object
      title: HTTPValidationError
    LabTestVersionSummary:
      properties:
        version:
          type: integer
          title: Version
        created_at:
          type: string
          format: date-time
          title: Created At
        markers:
          items:
            $ref: '#/components/schemas/LabTestVersionMarkerSummary'
          type: array
          title: Markers
      type: object
      required:
        - version
        - created_at
        - markers
      title: LabTestVersionSummary
    LabTestVersionMarkerSummary:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
        provider_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Provider Id
      type: object
      required:
        - id
        - name
        - provider_id
      title: LabTestVersionMarkerSummary
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-vital-api-key
      description: Vital Team API Key

````

## Related topics

- [Get Lab Test](/api-reference/lab-testing/get-lab-test.md)
- [Get Markers for Lab Test](/api-reference/lab-testing/lab-test-markers.md)
- [Get Collection Instructions for Lab Test](/api-reference/lab-testing/lab-test-collection-instructions.md)
- [Get Collection Instructions PDF for Lab Test](/api-reference/lab-testing/lab-test-collection-instructions-pdf.md)
- [Lab Test Versioning](/lab/workflow/lab-test-versioning.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.