HomeGuidesAPI ReferenceAPI Changelog
Log In
API Reference

The invoice object

Attributes

Id string

Unique identifier for the invoice object.

CreatedDate datetime

ISO 8416 format of the date and time when the invoice was created.

MediaId integer

Unique identifier of the partner the invoice is for.

MediaName string

Display name of the partner the invoice is for.

Currency currency

Three-letter ISO 4217 currency code for the currency of the payments detailed in the invoice.

TotalAmount decimal

The total amount due to the partner in the invoice.

TotalVatAmount decimal

Value-added tax applied to the invoice, if any.

LineItems array

Line items displayed in the invoice.

Show attributes

CampaignId integer

Unique identifier for the campaign (or program) for the line item.

CampaignName string

Display name for the campaign (or program) for the line item.

Description enum

Describes what the payout in the line item is for.

Possible enum values
MEDIA_PAYOUT Payouts for actions that the partner was credited for.
BONUS Payout for a Partner Funds Transfer, such as a bonus, make good, or paid placement payout.

EventMonthYear string

Month (M or MM) and four-digit year (YYYY) of when the events that are being paid out occurred (e.g., January 2021 would be 12021).

Actions integer

Number of actions the payout is for.

NetItemAmount decimal

Cost of the line item before any applicable taxes.

VatItemAmount decimal

Amount of taxes assessed for the payout amount.

TotalItemAmount decimal

Total amount of line item, combining NetItemAmount and VatItemAmount.

Status enum

Payment status of the line item.

Possible enum values
PENDING Payment for the line item is still pending.
PAID Line item has already been paid for.
OVERDUE Payment for the line item is overdue.

DueDate datetime

ISO 8416 format of the date and time when payment for the line item is due.

PaidDate datetime

ISO 8416 format of the date and time when the line item was paid, if available.

DetailedLineItems array

Show attributes

AccountId integer

The unique identifier for the partner or media account.

Name string

The name of the partner or media account.

ProgramId integer

The unique identifier for the program.

ProgramName string

The name of the program.

EventMonthYear string

Month (M or MM) and four-digit year (YYYY) of when the events that are being paid out occurred (e.g., April 2021 would be 42021).

ActionAmount decimal

The total amount from actions during the event month.

OtherAmount decimal

Additional amount not tied to tracked actions (e.g., bonuses or adjustments).

TotalAmount decimal

The sum of actions and other amounts paid for the event month.

PDF string

Link to download the PDF for the invoice.

URI string

Unique identifier for the specific invoice in the impact.com API.

{
  "Id": "1299679-33",
  "CreatedDate": "2018-11-02T11:43:30-04:00",
  "MediaId": "1299679",
  "MediaName": "RoadRunner",
  "Currency": "USD",
  "TotalAmount": "65.00",
  "TotalVatAmount": "0.00",
  "LineItems": [
    {
    "CampaignId": "1000",
    "CampaignName": "Acme Online",
    "Description": "MEDIA_PAYOUT",
    "EventMonthYear": "92018",
    "Actions": "13",
    "NetItemAmount": "65.00",
    "VatItemAmount": "0.00",
    "TotalItemAmount": "65.00",
    "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.00",
      "OtherAmount": "",
      "TotalAmount": "65.00",
  ],
    }, 
  "PDF": "/Advertisers/<AccountSID>/Invoices/1299679-3/Download",
  "Uri": "/Advertisers/<AccountSID>/Invoices/1299679-3"
},