openapi: 3.1.0
info:
  title: Zamp API
  version: '2026-10-15'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-15: 9 operation(s) read from 11 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Zamp has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 11
    documentation: -2
    pages-with-code: 10
    pages-read: 11
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-15'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://developer.zamp.com/api-reference/filings.md
  - https://developer.zamp.com/api-reference/addresses.md
  - https://developer.zamp.com/api-reference/companies.md
  - https://developer.zamp.com/api-reference/introduction
  - https://developer.zamp.com/api-reference/tax-codes.md
  - https://developer.zamp.com/api-reference/calculations.md
  - https://developer.zamp.com/api-reference/introduction.md
  - https://developer.zamp.com/api-reference/transactions.md
  - https://developer.zamp.com/api-reference/registrations.md
  - https://developer.zamp.com/index.md
  - https://developer.zamp.com/guides/quickstart.md
servers:
- url: https://api.zamp.com
paths:
  /addresses:
    post:
      operationId: post_addresses
      tags:
      - Addresses
      summary: POST /addresses
      x-source: https://developer.zamp.com/api-reference/addresses.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAddressesRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAddressesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.zamp.com/addresses  -H \"Authorization: Bearer {token}\"  -H \"Content-Type: application/json\"  -d\
          \ '{\n      \"line1\": \"120 SW 10TH AVE\",\n      \"line2\": null,\n      \"city\": \"TOPEKA\",\n      \"state\": \"KS\",\n      \"\
          zip\": \"66612\"\n    }'\n  ```\n</RequestExample>"
  /calculations:
    post:
      operationId: post_calculations
      tags:
      - Calculations
      summary: POST /calculations
      x-source: https://developer.zamp.com/api-reference/calculations.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCalculationsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCalculationsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.zamp.com/calculations  -H \"Authorization: Bearer {token}\"  -H \"Content-Type: application/json\"\
          \  -d '{\n      \"id\": \"123\",\n      \"name\": \"INV-123\",\n      \"transactedAt\": \"2023-07-01T00:00:00.000Z\",\n      \"isResale\"\
          : false,\n      \"discount\": 2,\n      \"subtotal\": 18,\n      \"shippingHandling\": 5,\n      \"total\": 23,\n      \"shipToAddress\"\
          : {\n        \"line1\": \"120 SW 10TH AVE\",\n  "
  /companies:
    get:
      operationId: get_companies
      tags:
      - Companies
      summary: GET /companies
      x-source: https://developer.zamp.com/api-reference/companies.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCompaniesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -G https://api.zamp.com/companies  -H "Authorization: Bearer {token}"

          ```'
  /filings:
    get:
      operationId: get_filings
      tags:
      - Filings
      summary: GET /filings
      x-source: https://developer.zamp.com/api-reference/filings.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFilingsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.zamp.com/filings  -H "Authorization: Bearer {token}"  -d state=KS  -d minDueOn=2025-02-01  -d maxDueOn=2025-02-28

          ```'
  /registrations:
    get:
      operationId: get_registrations
      tags:
      - Registrations
      summary: GET /registrations
      x-source: https://developer.zamp.com/api-reference/registrations.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetRegistrationsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -G https://api.zamp.com/registrations  -H "Authorization: Bearer {token}"  -d state=KS

          ```'
  /tax-codes:
    get:
      operationId: get_tax_codes
      tags:
      - Tax Codes
      summary: GET /tax-codes
      x-source: https://developer.zamp.com/api-reference/tax-codes.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTaxCodesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -G https://api.zamp.com/tax-codes  -H "Authorization: Bearer {token}"

          ```'
  /transactions:
    delete:
      operationId: delete_transactions
      tags:
      - Transactions
      summary: Delete a Transaction
      x-source: https://developer.zamp.com/api-reference/transactions.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_transactions
      tags:
      - Transactions
      summary: GET /transactions
      x-source: https://developer.zamp.com/api-reference/introduction
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.zamp.com/transactions  -H \"Authorization: Bearer {token}\" \n See the Authentication guide for details on\
          \ obtaining a token. \n ​ Conventions \n Errors Status codes and error response formats. Pagination Work with cursor-paginated list\
          \ responses. Transaction object The shared shape behind calculations and transactions. \n ​ Available endpoints \n Addresses Validate\
          \ addresses before coll"
    post:
      operationId: post_transactions
      tags:
      - Transactions
      summary: POST /transactions
      x-source: https://developer.zamp.com/api-reference/transactions.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostTransactionsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTransactionsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.zamp.com/transactions  -H \"Authorization: Bearer {token}\"  -H \"Content-Type: application/json\"\
          \  -d '{\n    \"id\": \"123\",\n    \"name\": \"INV-123\",\n    \"transactedAt\": \"2023-07-01T00:00:00.000Z\",\n    \"isResale\": false,\n\
          \    \"currency\": \"USD\",\n    \"discount\": 2,\n    \"subtotal\": 18,\n    \"shippingHandling\": 5,\n    \"taxCollected\": 2.25,\n\
          \    \"total\": 25.25,\n    \"shipToAddress\": {\n    "
components:
  schemas:
    PostAddressesRequest:
      type: object
      properties:
        line1:
          type: string
        line2:
          type:
          - string
          - 'null'
        city:
          type: string
        state:
          type: string
        zip:
          type: string
    PostAddressesResponse:
      type: object
      properties:
        originalAddress:
          type: object
          properties:
            line1:
              type: string
            line2:
              type:
              - string
              - 'null'
            city:
              type: string
            state:
              type: string
            zip:
              type: string
            country:
              type: string
        validatedAddress:
          type: object
          properties:
            coordinates:
              type: array
              items:
                type: number
            line1:
              type: string
            line2:
              type:
              - string
              - 'null'
            city:
              type: string
            state:
              type: string
            zip:
              type: string
            country:
              type: string
    PostCalculationsRequest:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        transactedAt:
          type: string
          format: date-time
        isResale:
          type: boolean
        discount:
          type: integer
        subtotal:
          type: integer
        shippingHandling:
          type: integer
        total:
          type: integer
        shipToAddress:
          type: object
          properties:
            line1:
              type: string
            line2:
              type:
              - string
              - 'null'
            state:
              type: string
            city:
              type: string
            zip:
              type: string
            coordinates:
              type:
              - string
              - 'null'
        lineItems:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              amount:
                type: integer
              quantity:
                type: integer
              discount:
                type: integer
              shippingHandling:
                type: integer
              productName:
                type: string
              productSku:
                type: string
              productTaxCode:
                type: string
    PostCalculationsResponse:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        taxDue:
          type: number
        taxes:
          type: array
          items:
            type: object
            properties:
              lineItemId:
                type: string
              state:
                type: string
              sourcing:
                type: string
              jurisdictionCode:
                type: string
              jurisdictionName:
                type: string
              jurisdictionDivision:
                type: string
              compositeCode:
                type: string
              compositeName:
                type: string
              exceptionCode:
                type: string
              ancillaryType:
                type:
                - string
                - 'null'
              taxableAmount:
                type: integer
              nontaxableAmount:
                type: integer
              excludedAmount:
                type: integer
              taxRate:
                type: number
              taxDue:
                type: number
              taxCollected:
                type: integer
    GetCompaniesResponse:
      type: object
      properties:
        id:
          type: string
        legalName:
          type: string
        dbaName:
          type: string
    GetFilingsResponse:
      type: object
      properties:
        prevCursor:
          type:
          - string
          - 'null'
        nextCursor:
          type:
          - string
          - 'null'
        data:
          type: array
          items:
            type: object
            properties:
              state:
                type: string
              period:
                type: object
                properties:
                  code:
                    type: string
                  name:
                    type: string
              frequency:
                type: object
                properties:
                  code:
                    type: string
                  name:
                    type: string
              dueOn:
                type: string
                format: date
              isCompleted:
                type: boolean
              estimatedTaxDue:
                type: number
              artifacts:
                type: array
                items: {}
    GetRegistrationsResponse:
      type: object
      properties:
        state:
          type: string
        registration:
          type: object
          properties:
            taxId:
              type: string
            startedAt:
              type: string
              format: date
            endedAt:
              type:
              - string
              - 'null'
        location:
          type: object
          properties:
            line1:
              type: string
            line2:
              type:
              - string
              - 'null'
            city:
              type: string
            state:
              type: string
            zip:
              type: string
        frequencies:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              startedAt:
                type: string
                format: date
              endedAt:
                type:
                - string
                - 'null'
    GetTaxCodesResponse:
      type: object
      properties:
        code:
          type: string
        name:
          type: string
        description:
          type: string
    PostTransactionsRequest:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        transactedAt:
          type: string
          format: date-time
        isResale:
          type: boolean
        currency:
          type: string
        discount:
          type: integer
        subtotal:
          type: integer
        shippingHandling:
          type: integer
        taxCollected:
          type: number
        total:
          type: number
        shipToAddress:
          type: object
          properties:
            line1:
              type: string
            state:
              type: string
            city:
              type: string
            zip:
              type: string
            coordinates:
              type:
              - string
              - 'null'
        lineItems:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              amount:
                type: integer
              quantity:
                type: integer
              productName:
                type: string
              productSku:
                type: string
              productTaxCode:
                type: string
        metadata:
          type: object
          properties:
            version:
              type: string
    PostTransactionsResponse:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        taxDue:
          type: number
        taxes:
          type: array
          items:
            type: object
            properties:
              lineItemId:
                type: string
              state:
                type: string
              sourcing:
                type: string
              jurisdictionCode:
                type: string
              jurisdictionName:
                type: string
              jurisdictionDivision:
                type: string
              compositeCode:
                type: string
              compositeName:
                type: string
              exceptionCode:
                type: string
              ancillaryType:
                type:
                - string
                - 'null'
              taxableAmount:
                type: integer
              nontaxableAmount:
                type: integer
              excludedAmount:
                type: integer
              taxRate:
                type: number
              taxDue:
                type: number
              taxCollected:
                type: number
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Addresses
- name: Calculations
- name: Companies
- name: Filings
- name: Registrations
- name: Tax Codes
- name: Transactions