Amazon Business Ab Invoice API

openapi: 3.2.0
info:
  title: Amazon Business Ab Invoice API
  version: '2026-10-13'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-13: 19 operation(s) read from 8 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Amazon Business has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 19
    pages-with-code: 0
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-13'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.business.amazon.com/docs/document-api
  - https://docs.business.amazon.com/docs/ordering-api
  - https://docs.business.amazon.com/docs/e-invoicing-for-ordering-api
  - https://docs.business.amazon.com/docs/sample-endpoints
  - https://docs.business.amazon.com/docs/cart-api-v1-reference
  - https://docs.business.amazon.com/docs/invoices-api-reference
  - https://docs.business.amazon.com/docs/ordering-api-v1-reference
  - https://docs.business.amazon.com/docs/document-api-v1-reference-1
servers:
- url: https://na.business-api.amazon.com
tags:
- name: Ab Invoice
paths:
  /ab-invoice/2026-02-01/invoices:
    get:
      operationId: get_ab_invoice_2026_02_01_invoices
      tags:
      - Ab Invoice
      summary: Returns a paginated list of invoices within the specified date range
      x-source: https://docs.business.amazon.com/docs/invoices-api-reference
      parameters:
      - name: invoiceIssueStartDate
        in: query
        required: true
        schema:
          type: string
        description: The start of the invoice issue date range to search for invoices, in ISO 8601 format. Must not be more than 366 days before invoiceIssueEndDate .
      - name: invoiceIssueEndDate
        in: query
        required: true
        schema:
          type: string
        description: The end of the invoice issue date range to search for invoices, in ISO 8601 format. Must not be in the future and must not be more than 366 days after invoiceIssueStartDate .
      - name: region
        in: query
        required: false
        schema:
          type: string
        description: 'Marketplace region (currently: JP).'
      - name: nextPageToken
        in: query
        required: false
        schema:
          type: string
        description: A page token returned in response to your previous request when the number of results exceed the page size. Must be used with the same query parameters as the original request.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAbInvoice20260201InvoicesResponse'
      x-evidence:
        kind: documentation
  /ab-invoice/2026-02-01/invoices/{invoicenumber}:
    get:
      operationId: get_ab_invoice_2026_02_01_invoices_invoicenumber
      tags:
      - Ab Invoice
      summary: Returns detailed information for a specific invoice identified by its invoice…
      x-source: https://docs.business.amazon.com/docs/invoices-api-reference
      parameters:
      - name: invoicenumber
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: 'Marketplace region (currently: JP).'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAbInvoice20260201InvoicesInvoicenumberResponse'
      x-evidence:
        kind: documentation
  /ab-invoice/2026-02-01/invoices/{invoicenumber}/lineItems:
    get:
      operationId: get_ab_invoice_2026_02_01_invoices_invoicenumber_lineItems
      tags:
      - Ab Invoice
      summary: Returns paginated line items for a given invoice.
      x-source: https://docs.business.amazon.com/docs/invoices-api-reference
      parameters:
      - name: invoicenumber
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: 'Marketplace region (currently: JP).'
      - name: nextPageToken
        in: query
        required: false
        schema:
          type: string
        description: A page token returned in response to your previous request. Tokens expire after 15 minutes.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAbInvoice20260201InvoicesInvoicenumberLineitemsResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetAbInvoice20260201InvoicesInvoicenumberLineitemsResponse:
      type: object
      properties:
        '200':
          type: string
          description: Success.
        '400':
          type: string
          description: Request has missing or invalid parameters and cannot be parsed.
        '401':
          type: string
          description: The request's Authorization header is not formatted correctly or does not contain a valid token.
        '403':
          type: string
          description: Indicates that access to the resource is forbidden.
        '404':
          type: string
          description: The resource specified does not exist.
        '429':
          type: string
          description: The frequency of requests was greater than allowed.
        '500':
          type: string
          description: An unexpected condition occurred that prevented the server from fulfilling the request.
        '504':
          type: string
          description: A gateway timeout occurred.
    GetAbInvoice20260201InvoicesResponse:
      type: object
      properties:
        '200':
          type: string
          description: Success.
        '400':
          type: string
          description: Request has missing or invalid parameters and cannot be parsed.
        '401':
          type: string
          description: The request's Authorization header is not formatted correctly or does not contain a valid token.
        '403':
          type: string
          description: Indicates that access to the resource is forbidden.
        '404':
          type: string
          description: The resource specified does not exist.
        '429':
          type: string
          description: The frequency of requests was greater than allowed.
        '500':
          type: string
          description: An unexpected condition occurred that prevented the server from fulfilling the request.
        '504':
          type: string
          description: A gateway timeout occurred.
    GetAbInvoice20260201InvoicesInvoicenumberResponse:
      type: object
      properties:
        '200':
          type: string
          description: Success.
        '400':
          type: string
          description: Request has missing or invalid parameters and cannot be parsed.
        '401':
          type: string
          description: The request's Authorization header is not formatted correctly or does not contain a valid token.
        '403':
          type: string
          description: Indicates that access to the resource is forbidden.
        '404':
          type: string
          description: The resource specified does not exist.
        '429':
          type: string
          description: The frequency of requests was greater than allowed.
        '500':
          type: string
          description: An unexpected condition occurred that prevented the server from fulfilling the request.
        '504':
          type: string
          description: A gateway timeout occurred.