# Invoices

## List all invoices

> Returns a list of invoices sorted by creation date (most recent first). \
> Use StartDate and EndDate to filter by a specific date range.<br>

```json
{"openapi":"3.1.0","info":{"title":"Brand Invoices API","version":"v11"},"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"Invoice":{"type":"object","properties":{"Id":{"type":"string","description":"The unique identifier for the invoice."},"CreatedDate":{"type":"string","format":"date-time","description":"The date and time the invoice was created."},"MediaId":{"type":"integer","description":"The unique identifier for the partner the invoice is for."},"MediaName":{"type":"string","description":"The display name of the partner the invoice is for."},"Currency":{"type":"string","description":"Three-letter ISO 4217 currency code for the invoice amounts."},"TotalAmount":{"type":"number","format":"decimal","description":"The total amount owed on the invoice."},"TotalVatAmount":{"type":"number","format":"decimal","description":"The total VAT amount on the invoice."},"LineItems":{"type":"array","description":"Summary line items for the invoice grouped by campaign and description.","items":{"$ref":"#/components/schemas/InvoiceLineItem"}},"DetailedLineItems":{"type":"array","description":"Detailed line items for the invoice with program-level breakdown.","items":{"$ref":"#/components/schemas/DetailedLineItem"}},"PDF":{"type":"string","format":"uri-reference","description":"The URI to download the PDF for the invoice."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to this invoice in the impact.com API."}}},"InvoiceLineItem":{"type":"object","properties":{"CampaignId":{"type":"integer","description":"The unique identifier of the campaign for this line item."},"CampaignName":{"type":"string","description":"The display name of the campaign."},"Description":{"type":"string","description":"The type of charge for this line item.","enum":["MEDIA_PAYOUT","BONUS"]},"EventMonthYear":{"type":"string","description":"The month and year (MYYYY) the events occurred."},"Actions":{"type":"integer","description":"The number of actions covered by this line item."},"NetItemAmount":{"type":"number","format":"decimal","description":"The net amount for this line item before VAT."},"VatItemAmount":{"type":"number","format":"decimal","description":"The VAT amount for this line item."},"TotalItemAmount":{"type":"number","format":"decimal","description":"The total amount for this line item (net + VAT)."},"Status":{"type":"string","description":"The payment status of this line item.","enum":["PENDING","PAID","OVERDUE"]},"DueDate":{"type":"string","format":"date-time","description":"The date and time payment is due."},"PaidDate":{"type":"string","format":"date-time","nullable":true,"description":"The date and time the line item was paid, if applicable."}}},"DetailedLineItem":{"type":"object","properties":{"AccountId":{"type":"integer","description":"The unique identifier for the partner account."},"Name":{"type":"string","description":"The display name of the partner account."},"ProgramId":{"type":"integer","description":"The unique identifier of the program."},"ProgramName":{"type":"string","description":"The display name of the program."},"EventMonthYear":{"type":"string","description":"The month and year (MYYYY) the events occurred."},"ActionAmount":{"type":"number","format":"decimal","description":"The amount owed for actions in this period."},"OtherAmount":{"type":"number","format":"decimal","nullable":true,"description":"Other amounts owed in this period, if any."},"TotalAmount":{"type":"number","format":"decimal","description":"The total amount for this detailed line item."}}}}},"paths":{"/Advertisers/{AccountSID}/Invoices":{"get":{"operationId":"listInvoices","tags":["Invoices"],"summary":"List all invoices","description":"Returns a list of invoices sorted by creation date (most recent first). \nUse StartDate and EndDate to filter by a specific date range.\n","parameters":[{"name":"AccountSID","in":"path","required":true,"description":"The unique identifier for the account.","schema":{"type":"string"}},{"name":"StartDate","in":"query","required":false,"description":"Filter invoices created on or after this date (ISO 8601).","schema":{"type":"string","format":"date-time"}},{"name":"EndDate","in":"query","required":false,"description":"Filter invoices created on or before this date (ISO 8601).","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"A list of invoice objects.","content":{"application/json":{"schema":{"type":"object","properties":{"Invoices":{"type":"array","description":"The list of invoice objects.","items":{"$ref":"#/components/schemas/Invoice"}}}}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/brand-api-reference-v11/reference/invoices/invoices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.