getInvoicesExport

get https://sellingpartnerapi-na.amazon.com/tax/invoices/2024-06-19/exports/{exportId}

Returns invoice export details (including the exportDocumentId, if available) for the export that you specify.

Usage Plan:

Rate (requests per second)	Burst
2	15

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.

Responses

Response body

object

export

object

Detailed information about the export.

errorMessage

string

When the export generation fails, this attribute contains a description of the error.

exportId

string

The export identifier.

generateExportFinishedAt

date-time

The date and time when the export generation finished. Vales are in ISO 8601 date-time format.

generateExportStartedAt

date-time

The date and time when the export generation started. Values are in ISO 8601 date-time format.

invoicesDocumentIds

array of strings

The identifier for the export documents. To get the information required to retrieve the export document's contents, pass each ID in the getInvoicesDocument operation.

This list is empty until the status is DONE.

invoicesDocumentIds

status

string

The current status of the request.

REQUESTED PROCESSING DONE ERROR

Show Details

REQUESTED	The export request was created, but has not yet started.
PROCESSING	The export request is being processed.
DONE	The export request has finished successfully. Use the document IDs to download the output documents.
ERROR	The export request resulted in an error. Refer to the `errorMessage` attribute for more information.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://sellingpartnerapi-na.amazon.com/tax/invoices/2024-06-19/exports/exportId \
3
     --header 'accept: application/json'


xxxxxxxxxx
12
 
1
{
2
  "export": {
3
    "errorMessage": "string",
4
    "exportId": "string",
5
    "generateExportFinishedAt": "2025-04-01T16:44:09.245Z",
6
    "generateExportStartedAt": "2025-04-01T16:44:09.245Z",
7
    "invoicesDocumentIds": [
8
      "string"
9
    ],
10
    "status": "REQUESTED"
11
  }
12
}

200Success.

400Request has missing or invalid parameters and cannot be parsed.

401A list of error responses returned when a request is unsuccessful.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.