Invoices

List all invoices

get

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

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

Query parameters

StartDatestring · date-timeOptional

Filter invoices created on or after this date (ISO 8601).

EndDatestring · date-timeOptional

Filter invoices created on or before this date (ISO 8601).

Responses

200

A list of invoice objects.

application/json

get/Advertisers/{AccountSID}/Invoices

cURL

curl -L \
  --url 'https://api.impact.com/Advertisers/{AccountSID}/Invoices' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: */*'

200

A list of invoice objects.

{
  "Invoices": [
    {
      "Id": "1299679-33",
      "CreatedDate": "2018-11-02T11:43:30-04:00",
      "MediaId": 1299679,
      "MediaName": "RoadRunner",
      "Currency": "USD",
      "TotalAmount": 65,
      "TotalVatAmount": 0,
      "LineItems": [
        {
          "CampaignId": 1000,
          "CampaignName": "Acme Online",
          "Description": "MEDIA_PAYOUT",
          "EventMonthYear": "92018",
          "Actions": 13,
          "NetItemAmount": 65,
          "VatItemAmount": 0,
          "TotalItemAmount": 65,
          "Status": "PAID",
          "DueDate": "2018-10-16T00:00:00-04:00",
          "PaidDate": "2018-10-16T00:35:47-04:00"
        }
      ],
      "DetailedLineItems": [
        {
          "AccountId": 1299679,
          "Name": "ACME Online",
          "ProgramId": 1000,
          "ProgramName": "ACME Online",
          "EventMonthYear": "92018",
          "ActionAmount": 65,
          "OtherAmount": 0,
          "TotalAmount": 65
        }
      ],
      "PDF": "/Advertisers/<AccountSID>/Invoices/1924609-1/Download",
      "Uri": "/Advertisers/<AccountSID>/Invoices/1924609-1"
    }
  ]
}

Retrieve an invoice

get

Retrieves the detailed object for a specific invoice using its unique identifier.

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

InvoiceIdstringRequired

The unique identifier for the invoice.

Responses

200

A single invoice object.

application/json

IdstringOptional

The unique identifier for the invoice.

Example: 1299679-33

CreatedDatestring · date-timeOptional

The date and time the invoice was created.

Example: 2018-11-02T11:43:30-04:00

MediaIdintegerOptional

The unique identifier for the partner the invoice is for.

Example: 1299679

MediaNamestringOptional

The display name of the partner the invoice is for.

Example: RoadRunner

CurrencystringOptional

Three-letter ISO 4217 currency code for the invoice amounts.

Example: USD

TotalAmountnumber · decimalOptional

The total amount owed on the invoice.

Example: 65

TotalVatAmountnumber · decimalOptional

The total VAT amount on the invoice.

Example: 0

PDFstring · uri-referenceOptional

The URI to download the PDF for the invoice.

Example: /Advertisers/<AccountSID>/Invoices/1924609-1/Download

Uristring · uri-referenceOptional

The unique reference to this invoice in the impact.com API.

Example: /Advertisers/<AccountSID>/Invoices/1924609-1

get/Advertisers/{AccountSID}/Invoices/{InvoiceId}

cURL

curl -L \
  --url 'https://api.impact.com/Advertisers/{AccountSID}/Invoices/{InvoiceId}' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: */*'

200

A single invoice object.

{
  "Id": "1299679-33",
  "CreatedDate": "2018-11-02T11:43:30-04:00",
  "MediaId": 1299679,
  "MediaName": "RoadRunner",
  "Currency": "USD",
  "TotalAmount": 65,
  "TotalVatAmount": 0,
  "LineItems": [
    {
      "CampaignId": 1000,
      "CampaignName": "Acme Online",
      "Description": "MEDIA_PAYOUT",
      "EventMonthYear": "92018",
      "Actions": 13,
      "NetItemAmount": 65,
      "VatItemAmount": 0,
      "TotalItemAmount": 65,
      "Status": "PAID",
      "DueDate": "2018-10-16T00:00:00-04:00",
      "PaidDate": "2018-10-16T00:35:47-04:00"
    }
  ],
  "DetailedLineItems": [
    {
      "AccountId": 1299679,
      "Name": "ACME Online",
      "ProgramId": 1000,
      "ProgramName": "ACME Online",
      "EventMonthYear": "92018",
      "ActionAmount": 65,
      "OtherAmount": 0,
      "TotalAmount": 65
    }
  ],
  "PDF": "/Advertisers/<AccountSID>/Invoices/1924609-1/Download",
  "Uri": "/Advertisers/<AccountSID>/Invoices/1924609-1"
}

Download an invoice PDF

get

Returns the specified partner invoice as a downloadable PDF file.

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

The unique identifier for the account.

InvoiceIdstringRequired

The unique identifier for the invoice to download.

Responses

200

The invoice in PDF format.

application/pdf

string · binaryOptional

get/Advertisers/{AccountSID}/Invoices/{InvoiceId}/Download

cURL

curl -L \
  --url 'https://api.impact.com/Advertisers/{AccountSID}/Invoices/{InvoiceId}/Download' \
  --user '{AccountSID}:{AuthToken}' \
  --header 'Accept: */*'

200

The invoice in PDF format.

binary