overlay: 1.0.0
info:
  title: API Evangelist enhancements for Awin Accounts Transactions API
  version: 1.0.0
extends: openapi/awin-affiliate-transactions-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: https://help.awin.com/apidocs + this repo artifacts
actions:
- target: $.info
  description: Record API Evangelist provenance and the platform constraints Awin documents in prose but
    never encodes in a contract.
  update:
    x-apievangelist-provider: awin-affiliate
    x-apievangelist-enriched: '2026-08-13'
    x-apievangelist-spec-origin: reconstructed-from-docs
    x-apievangelist-docs: https://help.awin.com/apidocs/introduction-1
    x-apievangelist-llms-txt: https://help.awin.com/llms.txt
    x-rate-limit:
      requests: 20
      window: 1m
      scope: user
      headers: null
      exhaustion-status: 429
      docs: https://help.awin.com/apidocs/introduction-1
    x-idempotency:
      supported: false
      note: Awin documents no idempotency key on any surface.
    x-pagination:
      supported: false
      note: No page/offset/cursor/limit parameters; result sets are bounded by date windows.
    x-sandbox:
      available: false
      note: No test mode, no test credentials. Every call is production.
    x-status-page: https://status.awin.com
- target: $.paths['/publishers/{publisherId}/transactions/'].get
  description: Attach documentation link, agentic-access classification and the documented request constraints.
  update:
    x-apievangelist-docs: https://help.awin.com/apidocs/returns-a-list-of-transactions-for-a-given-publisher
    x-agentic-access:
      action-class: connected
      consequence: read
      token:
        max-ttl: 3600
    x-request-window:
      max-days: 31
      parameters:
      - startDate
      - endDate
      note: Awin rejects a span wider than 31 days; callers paginate by walking consecutive windows.
- target: $.paths['/advertisers/{advertiserId}/transactions/'].get
  description: Attach documentation link, agentic-access classification and the documented request constraints.
  update:
    x-apievangelist-docs: https://help.awin.com/apidocs/returns-a-list-of-transactions-for-a-given-advertiser
    x-agentic-access:
      action-class: connected
      consequence: read
      token:
        max-ttl: 3600
    x-request-window:
      max-days: 31
      parameters:
      - startDate
      - endDate
      note: Awin rejects a span wider than 31 days; callers paginate by walking consecutive windows.
    x-entitlement:
      plans:
      - Accelerate
      - Advanced
      note: Awin states advertiser API access is limited to the Accelerate and Advanced plans; a 403 here
        is commercial, not technical.