Marketing API Version

Invoices

Provides operation to read invoices assoicated with a campaign.

Read Invoices

Permissions

A user access token with Atlas API capability is required to request invoices details.

The calling user also need to be whitelisted for this feature. To learn more, reach out to your account manager.

Fields

Reading this endpoint returns a single or an array of Invoice objects with the same fields as the node.

Read Ad

You can get details of an invoice using the <INVOICE_ID> by making an HTTP GET request.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<INVOICE_ID>

Response:

{
  "id": "316633578460327", 
  "billing_period": "20150101", 
  "invoice_id": "9999998", 
}

Curl Example

A curl example to get the invoice detail:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<INVOICE_ID>

Read Campaign Invoices

You can get details of invoices associated with a campaign by making an HTTP GET request.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<CAMPAIGN_ID>/invoices

Response:

{
  "data": [
    {
      "billing_period": "20150101", 
      "invoice_id": "9999998", 
      "id": "836386156436424"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "ODM2Mzg2MTU2NDM2NDI0", 
      "after": "ODM2Mzg2MTU2NDM2NDI0"
    }
  }
}

Curl Example

A curl example to get invoices for a campaign:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<CAMPAIGN_ID>/invoices