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

# Bulk-subscribe from your 15-day call history

> Subscribe every token you've called in the last 15 days whose audit is already at the current prompt version (old-version tokens are skipped so no re-audit wave is triggered). Two-step: a bare POST is a DRY-RUN quote (creates/charges nothing); re-POST with `?confirm=true` to subscribe and be charged. Cap-gated on confirm.



## OpenAPI

````yaml /api-reference/openapi.json post /subscriptions/import-history
openapi: 3.1.0
info:
  title: Serialized Audit API
  version: 1.0.0
  description: Submit a contract address and chain, receive an instant risk verdict.
servers:
  - url: https://www.serializedaudit.io/api
security:
  - apiKey: []
paths:
  /subscriptions/import-history:
    post:
      summary: Bulk-subscribe from your 15-day call history
      description: >-
        Subscribe every token you've called in the last 15 days whose audit is
        already at the current prompt version (old-version tokens are skipped so
        no re-audit wave is triggered). Two-step: a bare POST is a DRY-RUN quote
        (creates/charges nothing); re-POST with `?confirm=true` to subscribe and
        be charged. Cap-gated on confirm.
      operationId: importHistorySubscriptions
      parameters:
        - name: confirm
          in: query
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
            default: 'false'
          description: true = actually subscribe + charge; otherwise a dry-run quote.
      responses:
        '200':
          description: Dry-run quote (default) or the confirmed subscribe result.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ImportHistoryDryRun'
                  - $ref: '#/components/schemas/SubscribeResult'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Billing wall.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentError'
        '429':
          description: 'Would cross the cap (`action: raise_cap`).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentError'
components:
  schemas:
    ImportHistoryDryRun:
      type: object
      properties:
        dry_run:
          type: boolean
        window_days:
          type: integer
        current_version_only:
          type: boolean
        would_subscribe:
          type: integer
          description: New tokens that would be subscribed.
        credits_per_token:
          type: integer
        credits_required:
          type: integer
        confirm_required:
          type: boolean
        hint:
          type: string
    SubscribeResult:
      type: object
      properties:
        ok:
          type: boolean
        subscribed:
          type: integer
          description: Total tokens subscribed by this call (including already-subscribed).
        charged:
          type: integer
          description: Genuinely-new subscriptions billed (2 credits each).
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message.
    PaymentError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
        action:
          type: string
          description: Suggested next step.
          enum:
            - wait
            - subscribe
            - add_payment
            - resubscribe
            - verify_payment
            - payment_processing
            - raise_cap
            - upgrade
      description: >-
        Billing denial. Bodies may carry additional context fields depending on
        the wall (resets_at, daily_limit, grace_usd, current_period_end,
        subscription_status).
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-Auth-Key
      description: Your secret API key. Create one from your dashboard.

````