Invoices API reference
Amazon Business Invoices API
Overview
The Amazon Business Invoice API provides capabilities for searching, retrieving, and viewing detailed invoice data for Amazon Business customers. The API supports invoice search by date range, detailed billing and tax breakdowns, and paginated line-item retrieval.
Version information
Version : 2026-02-01
Contact information
Contact : AB Support
Contact URL : https://developer-docs.amazon.com/amazon-business/
License information
License : Amazon Software License
License URL : https://aws.amazon.com/asl/
URI scheme
Host : api.business.amazon.com
Schemes : HTTPS
Consumes
application/json
Produces
application/json
External Docs
Description : Learn more about Amazon Business
URL : https://business.amazon.com
Operations
getInvoices
getInvoiceDetailByInvoiceNumber
getInvoiceLineItemsByInvoiceNumber
Paths
GET /ab-invoice/2026-02-01/invoices
Operation: getInvoices
Description
Returns a paginated list of invoices within the specified date range. This endpoint searches for invoices from all legal entities associated with the caller based on specified search criteria.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 2 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. For questions about your usage plan, reach out to your Amazon Business technical contact.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Query | invoiceIssueStartDate required | 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. | string |
| Query | invoiceIssueEndDate required | 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. | string |
| Query | region optional | Marketplace region (currently: JP). | enum (Region) |
| Query | nextPageToken optional | 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. | string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-RequestId (string): Unique request reference identifier. | GetInvoicesResponse |
| 400 | Request has missing or invalid parameters and cannot be parsed. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 403 | Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 404 | The resource specified does not exist. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 429 | The frequency of requests was greater than allowed. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 500 | An unexpected condition occurred that prevented the server from fulfilling the request. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 504 | A gateway timeout occurred. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
For additional error status codes, descriptions and schemas, see Error responses and schemas.
GET /ab-invoice/2026-02-01/invoices/{invoiceNumber}
Operation: getInvoiceDetailByInvoiceNumber
Description
Returns detailed information for a specific invoice identified by its invoice number.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 2 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. The preceding table indicates the default rate and burst values for this operation. For questions about your usage plan, reach out to your Amazon Business technical contact.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | invoiceNumber required | The unique identifier for the invoice. | string |
| Query | region required | Marketplace region (currently: JP). | enum (Region) |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-RequestId (string): Unique request reference identifier. | GetInvoiceDetailResponse |
| 400 | Request has missing or invalid parameters and cannot be parsed. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 403 | Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 404 | The resource specified does not exist. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 429 | The frequency of requests was greater than allowed. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 500 | An unexpected condition occurred that prevented the server from fulfilling the request. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 504 | A gateway timeout occurred. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
For additional error status codes, descriptions and schemas, see Error responses and schemas.
GET /ab-invoice/2026-02-01/invoices/{invoiceNumber}/lineItems
Operation: getInvoiceLineItemsByInvoiceNumber
Description
Returns paginated line items for a given invoice. Returns CHARGE items first, then REFUND items, maintaining order across pages.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 2 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. The preceding table indicates the default rate and burst values for this operation. For questions about your usage plan, reach out to your Amazon Business technical contact.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | invoiceNumber required | The invoice or credit memo ID number. | string |
| Query | region required | Marketplace region (currently: JP). | enum (Region) |
| Query | nextPageToken optional | A page token returned in response to your previous request. Tokens expire after 15 minutes. | string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-RequestId (string): Unique request reference identifier. | GetInvoiceLineItemsResponse |
| 400 | Request has missing or invalid parameters and cannot be parsed. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 403 | Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 404 | The resource specified does not exist. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 429 | The frequency of requests was greater than allowed. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 500 | An unexpected condition occurred that prevented the server from fulfilling the request. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
| 504 | A gateway timeout occurred. Headers: x-amzn-RateLimit-Limit (string): Your rate limit (requests per second) for this operation. x-amzn-requestId (string): Unique request reference identifier. | ErrorList |
For additional error status codes, descriptions and schemas, see Error responses and schemas.
Error responses and schemas
This table contains HTTP status codes and associated information for error responses.
| HTTP Code | Description | Schema |
|---|---|---|
| 413 | The request size exceeded the maximum accepted size. Headers: x-amzn-RequestId (string): Unique request reference identifier. | ErrorList |
| 415 | The request payload is in an unsupported format. Headers: x-amzn-RequestId (string): Unique request reference identifier. | ErrorList |
| 503 | Temporary overloading or maintenance of the server. Headers: x-amzn-RequestId (string): Unique request reference identifier. | ErrorList |
Definitions
GetInvoicesResponse
The response schema for the getInvoices operation. Returns up to 100 invoices per page.
| Name | Description | Schema |
|---|---|---|
| invoices required | The list of invoices matching the search criteria. Maximum 100 invoices per page. | < Invoice > array |
| nextPageToken optional | A token to retrieve the next page of results. | string |
InvoiceMetadata
Common invoice identification fields shared across invoice operations.
| Name | Description | Schema |
|---|---|---|
| invoiceNumber required | The unique identifier for the invoice. | string |
| issueDate required | The date when the invoice was issued, in ISO 8601 format with UTC timezone. Format: YYYY-MM-DDThh:mm:ssZ. | string |
| type required | The type of invoice. Possible values: STANDARD (standard invoice for purchases), CREDIT_MEMO (credit memo for returns). | string |
| region required | Marketplace region (currently: JP). | string |
Invoice
Key attributes of an invoice.
| Name | Description | Schema |
|---|---|---|
| invoiceMetadata required | Common invoice identification fields. | InvoiceMetadata |
| consolidationType optional | The type of invoice consolidation. Currently supported: PERIODIC (invoices generated on a regular schedule, e.g., monthly). | string |
| status optional | The current status of the invoice. Possible values: Closed, Past Due, Issued, Payment Processing. | string |
| dueDate optional | The date by which payment is due. | DateTime |
GetInvoiceDetailResponse
The response schema for the getInvoiceDetailByInvoiceNumber operation.
| Name | Description | Schema |
|---|---|---|
| invoiceDetail required | Detailed invoice information. | InvoiceDetail |
InvoiceDetail
Detailed information about an invoice.
| Name | Description | Schema |
|---|---|---|
| invoiceMetadata required | Common invoice identification fields. | InvoiceMetadata |
| associatedInvoiceNumber optional | The invoice number of the associated invoice. For a CREDIT_MEMO, this is the invoice number of the original STANDARD invoice. Null if not applicable. | string |
| period optional | The billing period covered by this invoice. | InvoicePeriod |
| issuer optional | The entity that issued the invoice. | InvoiceIssuer |
| billToAddress optional | The billing address for this invoice. | BillToAddress |
| customer optional | The customer associated with this invoice. | Customer |
| dueDate optional | The date by which payment is due. | DateTime |
| paymentMethod optional | The payment method used for this invoice. For example, Business Credit Account. | string |
| totalAmount optional | The total amount due for this invoice. | Money |
| artifacts optional | Additional invoice artifacts providing billing details and tax breakdowns. | < InvoiceArtifact > array |
InvoicePeriod
The billing period covered by the invoice.
| Name | Description | Schema |
|---|---|---|
| startDate required | The start date of the invoice billing period, in ISO 8601 format with UTC timezone. Format: YYYY-MM-DDThh:mm:ssZ. | string |
| endDate required | The end date of the invoice billing period, in ISO 8601 format with UTC timezone. Format: YYYY-MM-DDThh:mm:ssZ. | string |
InvoiceIssuer
The entity that issued the invoice.
| Name | Description | Schema |
|---|---|---|
| name required | The legal name of the invoice issuer. | string |
| registrationNumber optional | The tax registration number of the invoice issuer (for example, JCT registration number for Japan). | string |
BillToAddress
The billing address associated with the invoice.
| Name | Description | Schema |
|---|---|---|
| fullName optional | The full name of the billing contact. | string |
| phoneNumber optional | The phone number of the billing contact. | string |
| addressLine1 required | The first line of the billing address. | string |
| addressLine2 optional | The second line of the billing address. | string |
| city optional | The city of the billing address. | string |
| stateOrRegion optional | The state or region of the billing address. | string |
| postalCode optional | The postal code of the billing address. | string |
| countryCode required | The two-letter ISO 3166-1 alpha-2 country code of the billing address. | string |
Customer
The customer associated with the invoice.
| Name | Description | Schema |
|---|---|---|
| legalEntityId required | The legal entity identifier for the customer. | string |
| legalEntityName optional | The legal entity name of the customer. | string |
DateTime
The date format is based on ISO 8601.
| Name | Description | Schema |
|---|---|---|
| date required | The date and time in ISO 8601 format with UTC timezone. Format: YYYY-MM-DDThh:mm:ssZ. Example: 2025-01-15T10:30:00Z | string |
Money
Representation of a monetary value.
| Name | Description | Schema |
|---|---|---|
| currencyCode required | The currency code in ISO 4217 format. | string |
| amount required | The monetary amount. | number |
InvoiceArtifact
The base type for an invoice artifact. The artifactType field identifies the specific subtype.
Possible artifactType values:
BillingDetails: A breakdown of billing charges including subtotals, shipping, discounts, taxes, and amount due.PurchaseFromQualifiedIssuer: Tax breakdown for purchases from sellers with a JCT registration number.PurchaseFromOtherIssuer: Tax breakdown for purchases from sellers without a JCT registration number.
| Name | Description | Schema |
|---|---|---|
| artifactType required | The schema name of a subtype. | string |
BillingDetails
A breakdown of billing charges including subtotals, shipping, discounts, taxes, and amount due. Extends InvoiceArtifact.
| Name | Description | Schema |
|---|---|---|
| artifactType required | The schema name for the subtype. Value: BillingDetails. | string |
| amountDetails required | The list of billing charge line items. | < BillingDetail > array |
BillingDetail
A single billing charge line item.
| Name | Description | Schema |
|---|---|---|
| type required | The type of billing charge. Possible values: itemSubtotal, shippingAndHandling, promosAndDiscounts, refund, giftWrapping, otherExpenses, salesTax, amountDue. | string |
| amount required | The monetary amount for this billing charge. | Money |
PurchaseFromQualifiedIssuer
Tax breakdown for purchases from sellers with a JCT registration number. Extends InvoiceArtifact.
| Name | Description | Schema |
|---|---|---|
| artifactType required | The schema name for the subtype. Value: PurchaseFromQualifiedIssuer. | string |
| taxBreakdown required | The tax breakdown by tax rate for purchases from sellers with a JCT registration number. | < TaxBreakdown > array |
PurchaseFromOtherIssuer
Tax breakdown for purchases from sellers without a JCT registration number. Extends InvoiceArtifact.
| Name | Description | Schema |
|---|---|---|
| artifactType required | The schema name for the subtype. Value: PurchaseFromOtherIssuer. | string |
| taxBreakdown required | The tax breakdown by tax rate for purchases from sellers without a JCT registration number. | < TaxBreakdown > array |
TaxBreakdown
A tax breakdown entry for a specific tax rate.
| Name | Description | Schema |
|---|---|---|
| taxRate required | The tax rate as a decimal string (for example, 0.1 for 10%, 0.08 for 8%, 0 for tax-exempt). | string |
| inclusiveTotal required | The total amount including tax at this tax rate. | Money |
| exclusiveTotal required | The total amount excluding tax at this tax rate. | Money |
| taxAmount required | The tax amount at this tax rate. | Money |
GetInvoiceLineItemsResponse
The response schema for the getInvoiceLineItemsByInvoiceNumber operation. Returns up to 35 line items per page.
| Name | Description | Schema |
|---|---|---|
| lineItems required | List of invoice line items and reversal units. Maximum 35 items per page. | < InvoiceLineItem > array |
| nextPageToken optional | A token to retrieve the next page of results. Null if this is the last page. | string |
InvoiceLineItem
A line item or reversal unit within an invoice.
| Name | Description | Schema |
|---|---|---|
| invoiceNumber required | The invoice or credit memo number for which line items were requested. | string |
| transactionType required | The transaction type. Possible values: CHARGE, REFUND. | string |
| orderMetadata required | Metadata about an order including order ID and order date. | OrderMetadata |
| lineItemMetadata optional | Metadata specific to this line item. | LineItemMetadata |
| shipmentMetadata optional | Metadata about a shipment including shipment ID and shipment date. | ShipmentMetadata |
| purchaseOrderDetails optional | Purchase order information for this line item. | PurchaseOrderDetails |
| productDetails required | Details about the product in this line item. | ProductDetails |
| seller required | Information about the seller of this line item. | Seller |
| taxInvoiceNumber optional | The tax qualified invoice number for this line item. | string |
| quantity required | The quantity of items. | integer |
| taxRate optional | The tax rate applied to this line item. | string |
| charges required | List of charges associated with this line item. | < Charge > array |
| unitPrice required | The unit price for this line item, excluding tax. | Money |
| unitTax required | The tax amount per unit for this line item. | Money |
| unitPriceIncludingTax optional | The unit price for this line item, including tax. | Money |
| totalTaxAmount optional | Total tax amount for this line item. | Money |
| netTotal required | The total of all charges for this line item, including tax. | Money |
| businessOrderInfo optional | Additional business-specific information about the order. | object |
| shippingAddress optional | The shipping address for the shipment. | ShippingAddress |
| reversalDetails optional | Reversal details for credit memo line items. Null for invoice line items. | ReversalDetails |
| buyingCustomer optional | The customer who placed the order. | BuyingCustomer |
OrderMetadata
Metadata about an order including order ID and order date.
| Name | Description | Schema |
|---|---|---|
| orderId required | The unique identifier for the order. | string |
| orderDate required | The date when the order was placed. | DateTime |
LineItemMetadata
Metadata specific to a line item.
| Name | Description | Schema |
|---|---|---|
| orderLineItemId required | The unique identifier assigned to this specific line item in the order. | string |
ShipmentMetadata
Metadata about a shipment including shipment ID and shipment date.
| Name | Description | Schema |
|---|---|---|
| shipmentId required | The unique identifier for the shipment. | string |
| shipmentDate required | The date when the shipment was made. | DateTime |
PurchaseOrderDetails
Purchase order information for a line item.
| Name | Description | Schema |
|---|---|---|
| purchaseOrderNumber required | The purchase order number associated with this line item. | string |
| purchaseOrderLineItemNumber optional | The reference number that identifies this line item on the purchase order. | string |
ProductDetails
Information about a product.
| Name | Description | Schema |
|---|---|---|
| asin required | The Amazon Standard Identification Number (ASIN) of the product. | string |
| title required | The title of the product. | string |
| unspsc optional | The United Nations Standard Products and Services Code (UNSPSC) for the product. | Unspsc |
Seller
Information about the seller of a line item.
| Name | Description | Schema |
|---|---|---|
| name required | The name of the seller. | string |
| taxRegistrationNumber optional | The seller's tax registration number (e.g., JCT qualified invoice issuer registration number). | string |
Charge
A charge associated with a line item.
| Name | Description | Schema |
|---|---|---|
| category required | The category of charge. Values: SUBTOTAL, SHIPPING_AND_HANDLING, PROMOTION, GIFT_WRAP, DISCOUNT, OTHER_FEE, RESTOCKING_FEE, RETURN_SHIPPING_FEE. | string |
| type required | The type of the charge amount. Possible values: PRINCIPAL, TAX. | string |
| amount required | The monetary amount for this charge. | Money |
ShippingAddress
A detailed shipping address with recipient information.
| Name | Description | Schema |
|---|---|---|
| fullName required | The full name of the recipient. | string |
| addressLine1 required | The primary address line. | string |
| addressLine2 optional | The secondary address line. | string |
| city required | The city name. | string |
| stateOrRegion optional | The state or region. Mandatory for addresses in the US. | string |
| postalCode required | The postal code. | string |
| countryCode required | The country code in ISO 3166-1 alpha-2 format. | string |
Unspsc
United Nations Standard Products and Services Code (UNSPSC).
| Name | Description | Schema |
|---|---|---|
| code required | The UNSPSC code. | string |
ReversalDetails
Details about a reversal for credit memo line items.
| Name | Description | Schema |
|---|---|---|
| originalInvoiceNumber required | The invoice number of the original invoice that this credit memo reverses. | string |
| reversalDate required | The date of the reversal. | DateTime |
| reversalReason required | The reason for the reversal. | string |
BuyingCustomer
The customer who placed the order.
| Name | Description | Schema |
|---|---|---|
| name required | The name of the customer. | string |
| email required | The email address of the customer. | string |
BuyerGroup
The buyer group associated with the order.
| Name | Description | Schema |
|---|---|---|
| name required | The name of the buyer group. | string |
ErrorList
A list of error responses returned when a request is unsuccessful.
| Name | Description | Schema |
|---|---|---|
| errors required | A list of errors. | < Error > array |
Error
Error response returned when the request is unsuccessful.
| Name | Description | Schema |
|---|---|---|
| code required | An error code that identifies the type of error that occurred. | string |
| message required | A message that describes the error condition. | string |
| details optional | Additional details that can help the caller understand or fix the issue. | string |
Updated about 7 hours ago
Did this page help you?