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

# Unlock Historical Edition

> Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read, archive:unlock. Requires account-owner approval in both REST and hosted MCP. Submit the exact edition date with a saved Idempotency-Key; on confirmation_required, give the owner the returned confirmation_url and retry the identical request with the same key after approval. Opening a new historical date can consume the account allowance. The latest edition is included; historical dates outside the rolling 90 Eastern calendar dates return archive_expired even if opened earlier.



## OpenAPI

````yaml /openapi.json post /editions/{id}/access
openapi: 3.1.1
info:
  title: TruckerFetch Pro API
  version: 1.0.0
  description: >-
    Owner-scoped carrier, authority and observed-insurance research. All data
    operations require active Pro. Additional scopes, historical grants, source
    availability and current suppressions apply. Source observation, effective
    dates, edition dates and renewal estimates represent distinct facts.
servers:
  - url: https://truckerfetch.com/api/v1
security: []
paths:
  /editions/{id}/access:
    post:
      summary: Unlock Historical Edition
      description: >-
        Requires active Pro and an owner-scoped REST bearer key. Required
        scopes: data:read, archive:unlock. Requires account-owner approval in
        both REST and hosted MCP. Submit the exact edition date with a saved
        Idempotency-Key; on confirmation_required, give the owner the returned
        confirmation_url and retry the identical request with the same key after
        approval. Opening a new historical date can consume the account
        allowance. The latest edition is included; historical dates outside the
        rolling 90 Eastern calendar dates return archive_expired even if opened
        earlier.
      operationId: unlockHistoricalEdition
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
        - in: header
          name: Idempotency-Key
          required: true
          description: >-
            Persist this key with the exact request payload and reuse both after
            a timeout or confirmation; a changed payload conflicts.
          schema:
            type: string
            minLength: 8
            maxLength: 128
            pattern: ^[-._:a-zA-Z0-9]{8,128}$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                confirm_edition_date_et:
                  type: string
                  format: date
                  pattern: >-
                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
              required:
                - confirm_edition_date_et
              additionalProperties: false
      responses:
        '200':
          description: Authorized operation result
          headers:
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data: {}
                  meta:
                    type: object
                  next_cursor:
                    type: string
        '400':
          description: Invalid request
        '401':
          description: Credential required
        '402':
          description: Active Pro required
        '403':
          description: Insufficient scope or allowance
        '404':
          description: Unknown or inaccessible resource
        '409':
          description: >-
            Idempotency conflict, changed projection or owner confirmation
            required
        '410':
          description: >-
            Expired cursor, artifact or dated edition outside the rolling 90-day
            Lead History window (archive_expired); the latest published edition
            remains available
        '429':
          description: Request limit exceeded
          headers:
            Retry-After:
              schema:
                type: string
        '503':
          description: Service or binding unavailable
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Owner-scoped Pro API key

````

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