# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Avalara Free API
  version: 1.0.0
extends: openapi/avalara-free-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/api/v2/taxrates/byaddress'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up free tax rates by street address
      effect: read
      questions:
      - What is the combined sales tax rate at a specific street address?
      - Can I get an estimated tax rate for an address without a paid account?
      instructions:
      - text: Get the tax rate for {line1}, {region} {postalCode}, {country}.
        slots:
          line1: query.line1
          region: query.region
          postalCode: query.postalCode
          country: query.country
      - text: Look up the combined rate at {line1}, {city}, {region} {postalCode} {country}.
        slots:
          line1: query.line1
          city: query.city
          region: query.region
          postalCode: query.postalCode
          country: query.country
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/taxrates/bypostalcode'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up free tax rates by postal code
      effect: read
      questions:
      - What is the estimated sales tax rate for a ZIP code?
      - Can I get a tax rate from just a postal code and country?
      instructions:
      - text: Get the tax rate for postal code {postalCode} in {country}.
        slots:
          postalCode: query.postalCode
          country: query.country
      - text: Estimate the combined rate for ZIP {postalCode}, country {country}.
        slots:
          postalCode: query.postalCode
          country: query.country
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/accounts/freetrials/request'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a free AvaTax trial account
      effect: write
      questions:
      - How do I sign up for a free AvaTax trial account?
      - Do I need credentials to request a free trial?
      - What can I still use after my free trial ends?
      instructions:
      - text: Request a free AvaTax trial account.
      - text: Sign me up for a free trial of AvaTax.
      method: generated
      generated: '2026-10-01'