Get a list of invoice items for a given month and year.

Method: GET (paginated)

Parameters:

• “limit”
  • Maximum number of reports returned
    • One report is one day of reporting for a single ASIN/source
  • Default value: 100
  • Maximum value: 250
• “cursor”
  • Cursor for pagination
• “year”
  • The year of the invoice you want to get information on
• “month”
  • The month of the invoice you want to get information about
  • 0-indexed
• “brand_ids”
  • Brand IDs to filter on
  • Optional
• “marketplace”
  • Marketplace filter

Response:

{
  "items": [
    {
      "brand": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string"
      },
      "month": 0,
      "year": 0,
      "sales": 0,
      "commission": 0,
      "status": "pending",
      "currency": "USD",
      "marketplace": "amazon.com"
    }
  ],
  "cursor": "string"
}

Errors:

• 400: Bad Request
  • Parameters incorrectly formatted or exceed permitted bounds
• 401: Unauthorized
  • Invalid or omitted API key

Example:

const API_KEY = "LEVANTA_API_KEY";
const ENDPOINT = "<https://app.levanta.io/api/creator/v1/invoices/items>";

let cursor;
const reports = [];

// Set up query parameters
const parameters = new URLSearchParams();
// Get 50 items per response
parameters.set("limit", 50);
// Get invoice from January 2024
parameters.set("year", 2024);
parameters.set("month", 0);

// Paginate through reports, stop when a value of null is returned for "cursor"
while (cursor !== null) {
    const response = await fetch(`${ENDPOINT}?${parameters.toString()}`, {
			method: "GET",
			headers: {
				Authorization: `Bearer ${API_KEY}`
			}
		});
	  const json = await response.json();
		// Store reports returned
	  reports.push(...json.reports);
    cursor = json.cursor;
    if (cursor) parameters.set("cursor", cursor);
}
console.log(reports);