Billing APIs (2.0)
Download OpenAPI specification:Download
The Billing API allows users to view summarized and detailed versions of invoices and credit memos. Users can filter the responses based on date range, account numbers, and transaction IDs. The user's permission is applied to retrieve the invoice summary, and invoice details will be from the past 12 months.
Retrieve billing summary
This method retrieves a summary invoice or credit memo information based on date range, account number or transactions ID for a user with billing viewing permission.
Authorizations:
query Parameters
startDate | string <date> Example: startDate=2021-09-17 Start date of invoice in |
endDate | string <date> Example: endDate=2021-10-17 End date of invoice in |
accountNumbers | Array of strings List of accounts to be filtered |
transactionIds | Array of strings List of transactions to be filtered |
offset | integer >= 0 Default: 0 Use offset to control the number of records to be skipped in the response. |
limit | integer [ 1 .. 200 ] Default: 10 Use limit to restrict the number of records in the response. |
Responses
Response Schema: application/json
Array of objects (invoiceSummaryDetails) | |||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||
object (pagination_summary) Pagination | |||||||||||||||||||||||||||||||||||||||||
|
Response samples
- 200
- 400
- 403
- 500
{- "data": [
- {
- "transactionId": "100000000001",
- "transactionType": "INVOICE",
- "transactionDate": "2021-01-15",
- "customerDetails": {
- "accountName": "Acme Corporation",
- "accountNumber": "100000",
- "address": {
- "addressLine1": "Company address",
- "city": "City",
- "countryCode": "ES",
- "zipCode": "000000"
}, - "region": "EMEA"
}, - "billingPurchaseOrder": "900000001",
- "billingCycle": "1st of the month",
- "billingContacts": {
- "firstName": "John"
}, - "paymentDueDate": "2021-02-14",
- "paymentTerms": "Net 30",
- "currencyCode": "EUR",
- "totalRecurringAmount": 0,
- "totalNonRecurringAmount": 4638.94,
- "totalAmount": 5613.12,
- "totalAdjustment": 0,
- "vatNumber": "VAT Number",
- "paymentInstructions": {
- "electronic": {
- "bankName": "Bank Name",
- "payeeName": "Equinix",
- "payeeAccountNumber": "001100011",
- "bankCode": "ES000000000000000001",
- "swiftCode": "CODE"
}
}, - "taxInfo": [
- {
- "description": "VAT at 21% on 4638.94",
- "value": 974.18
}
]
}, - {
- "transactionId": "100000000003",
- "transactionType": "CREDIT_MEMO",
- "transactionDate": "2021-01-14",
- "customerDetails": {
- "accountName": "Company Name",
- "accountNumber": "100000",
- "accountContact": "Attn: Accounts Payable",
- "address": {
- "addressLine1": "Company address",
- "city": "City",
- "countryCode": "ES",
- "zipCode": "000000"
}, - "region": "EMEA"
}, - "billingPurchaseOrder": "00000000",
- "billingCycle": "1st of every month",
- "billingContacts": {
- "firstName": "John"
}, - "currencyCode": "EUR",
- "totalRecurringAmount": -75519,
- "totalNonRecurringAmount": 0,
- "totalAmount": -90622.8,
- "totalAdjustment": 0,
- "vatNumber": "VAT",
- "taxInfo": [
- {
- "description": "VAT at 20% on -75519",
- "value": -15103.8
}
]
}
], - "pagination": {
- "offset": 0,
- "limit": 10,
- "total": 3,
- "next": "/invoices?limit=10&offset=0"
}
}
Retrieve billing details
This method retrieves detailed invoice or credit memo information based on date range, account number or transactions ID for a user with billing viewing permission.
Authorizations:
query Parameters
startDate | string <date> Example: startDate=2021-09-17 Start date of invoice in |
endDate | string <date> Example: endDate=2021-10-17 End date of invoice in |
accountNumbers | Array of strings List of accounts to be filtered |
transactionIds | Array of strings List of transactions to be filtered |
offset | integer >= 0 Default: 0 Use offset to control the number of records to be skipped in the response. |
limit | integer [ 1 .. 200 ] Default: 10 Use limit to restrict the number of records in the response. |
Responses
Response Schema: application/json
Array of objects (invoiceItems) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (pagination) Paginations | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Response samples
- 200
- 400
- 403
- 500
{- "data": [
- {
- "transactionId": "100000000001",
- "businessLegalEntity": "01-Equinix",
- "region": "EMEA",
- "countryCode": "ES",
- "transactionType": "INVOICE",
- "transactionDate": "2021-01-15",
- "orderId": "1-12345696782012",
- "channel": "PORTAL",
- "subChannel": "ECP",
- "lineNumber": "3",
- "subLineNumber": "1",
- "customerDetails": {
- "accountName": "Acme Corporation",
- "accountNumber": "100000",
- "legalEntity": "Acme Corporation",
- "region": "EMEA",
- "countryCode": "ES"
}, - "purchaseOrderNumber": "1000000000",
- "billingAgreementId": "1-1000000000",
- "customerReferenceId": "Customer Reference Number",
- "ibxs": [
- "AM1"
], - "contacts": [
- {
- "firstName": "John",
- "type": "BOOKED_BY"
}, - {
- "firstName": "Jane",
- "type": "BILLING_ANALYST"
}
], - "orderBookedDate": "2020-09-15T00:00:00.000Z",
- "activityType": "CREDIT_MRC",
- "productName": "Cross Connect",
- "productCategory": "Espace",
- "productDescription": "Private Cage ( 900 kVA-Draw Cap / Metered Power )",
- "productCode": "CAG00001",
- "detailedDescription": "( Location: 00000 / S/N: 00000-123456789 )",
- "ibxDescription": "Data Center - AM1",
- "quantity": -1,
- "unitOfMeasure": "kVA",
- "unitPrice": 75519,
- "frequency": "MONTHLY",
- "currencyCode": "EUR",
- "localCurrencyCode": "EUR",
- "nonRecurringAmount": 0,
- "recurringAmount": -75519,
- "adjustment": 0,
- "taxAmount": -15103.8,
- "totalAmount": -90622.8,
- "additionalInfo": [
- {
- "key": "SERIAL_NUMBER",
- "value": "00000-123456789"
}, - {
- "key": "SPACE_ID",
- "value": "AM1:01:000000"
}, - {
- "key": "FIRST_PRICE_INCREASE",
- "value": 12
}, - {
- "key": "PRICE_INCREASE_PERCENTAGE",
- "value": 5
}
], - "termsOfUse": [
- {
- "value": 36,
- "type": "INITIAL_TERM",
- "period": "MONTHS"
}, - {
- "value": 12,
- "type": "RENEWAL_TERM",
- "period": "MONTHS"
}
]
}
], - "pagination": {
- "offset": 0,
- "limit": 1,
- "total": 3,
- "next": "/invoices/details?limit=1&offset=1"
}
}