# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure BillingClient Invoices API
  version: 1.0.0
extends: openapi/microsoft-azure-invoices-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Billing/invoices'].get
  update:
    x-apievangelist-phrasing:
      intent: List invoices for a subscription
      effect: read
      questions:
      - What invoices have been issued for my Azure subscription, newest first?
      - Can I filter invoices by billing period end date and include download links?
      instructions:
      - text: List invoices for subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show my {top} most recent invoices with download URLs expanded via {expand}.
        slots:
          top: query.$top
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Billing/invoices/{invoiceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a specific invoice
      effect: read
      questions:
      - How do I fetch one invoice by its name, with a download link?
      - Where can I get the PDF download URL for a particular past invoice?
      instructions:
      - text: Get invoice {invoiceName} for subscription {subscriptionId}.
        slots:
          invoiceName: path.invoiceName
          subscriptionId: path.subscriptionId
      - text: Download invoice {invoiceName}.
        slots:
          invoiceName: path.invoiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Billing/invoices/latest'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the most recent invoice
      effect: read
      questions:
      - What is my latest Azure invoice?
      - Can I grab the download link for this month's most recent invoice?
      instructions:
      - text: Get the latest invoice for subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Fetch my newest invoice.
      method: generated
      generated: '2026-09-26'