Create an invoice
curl --request POST \
--url https://eu.sequencehq.com/api/invoices \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"billingScheduleId": "fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95",
"currency": "GBP",
"dueDate": "2022-09-30",
"purchaseOrderNumber": "PO123",
"reference": "ref",
"customerEmails": [
"customer.user.a@example.com",
"customer.user.b@example.com"
],
"customerLegalCompanyName": "Facebook",
"customerBillingAddress": {
"line1": "Flat 1",
"line2": "15 Yemen Road",
"town": "Yemen",
"state": "CA",
"postcode": "YE1 2YE",
"country": "YE"
},
"customerShippingAddress": {
"line1": "742 Evergreen Terrace",
"town": "Springfield",
"state": "CA",
"postcode": "12345",
"country": "US"
},
"memo": "Thanks",
"paymentOptions": [
"BANK_TRANSFER"
],
"billingPeriod": {
"start": "2022-10-01",
"endInclusive": "2022-10-30"
},
"customerId": "61b083e0-1faa-47ca-9aeb-6205da8f6c47",
"metadata": [
{
"key": "example-label",
"value": "label-value"
}
],
"creditBalances": "Verification 2 credit balance: 7/7 (expiring on 4 May 2023)",
"billingRunId": "53ff21c8-4872-46c4-83bf-517d54876945",
"accountingDate": "2022-09-30",
"attachmentAssetIds": [
"99874519-25ce-46ff-8823-093115aa7222"
]
}
'import requests
url = "https://eu.sequencehq.com/api/invoices"
payload = {
"billingScheduleId": "fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95",
"currency": "GBP",
"dueDate": "2022-09-30",
"purchaseOrderNumber": "PO123",
"reference": "ref",
"customerEmails": ["customer.user.a@example.com", "customer.user.b@example.com"],
"customerLegalCompanyName": "Facebook",
"customerBillingAddress": {
"line1": "Flat 1",
"line2": "15 Yemen Road",
"town": "Yemen",
"state": "CA",
"postcode": "YE1 2YE",
"country": "YE"
},
"customerShippingAddress": {
"line1": "742 Evergreen Terrace",
"town": "Springfield",
"state": "CA",
"postcode": "12345",
"country": "US"
},
"memo": "Thanks",
"paymentOptions": ["BANK_TRANSFER"],
"billingPeriod": {
"start": "2022-10-01",
"endInclusive": "2022-10-30"
},
"customerId": "61b083e0-1faa-47ca-9aeb-6205da8f6c47",
"metadata": [
{
"key": "example-label",
"value": "label-value"
}
],
"creditBalances": "Verification 2 credit balance: 7/7 (expiring on 4 May 2023)",
"billingRunId": "53ff21c8-4872-46c4-83bf-517d54876945",
"accountingDate": "2022-09-30",
"attachmentAssetIds": ["99874519-25ce-46ff-8823-093115aa7222"]
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({
billingScheduleId: 'fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95',
currency: 'GBP',
dueDate: '2022-09-30',
purchaseOrderNumber: 'PO123',
reference: 'ref',
customerEmails: ['customer.user.a@example.com', 'customer.user.b@example.com'],
customerLegalCompanyName: 'Facebook',
customerBillingAddress: {
line1: 'Flat 1',
line2: '15 Yemen Road',
town: 'Yemen',
state: 'CA',
postcode: 'YE1 2YE',
country: 'YE'
},
customerShippingAddress: {
line1: '742 Evergreen Terrace',
town: 'Springfield',
state: 'CA',
postcode: '12345',
country: 'US'
},
memo: 'Thanks',
paymentOptions: ['BANK_TRANSFER'],
billingPeriod: {start: '2022-10-01', endInclusive: '2022-10-30'},
customerId: '61b083e0-1faa-47ca-9aeb-6205da8f6c47',
metadata: [{key: 'example-label', value: 'label-value'}],
creditBalances: 'Verification 2 credit balance: 7/7 (expiring on 4 May 2023)',
billingRunId: '53ff21c8-4872-46c4-83bf-517d54876945',
accountingDate: '2022-09-30',
attachmentAssetIds: ['99874519-25ce-46ff-8823-093115aa7222']
})
};
fetch('https://eu.sequencehq.com/api/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu.sequencehq.com/api/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'billingScheduleId' => 'fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95',
'currency' => 'GBP',
'dueDate' => '2022-09-30',
'purchaseOrderNumber' => 'PO123',
'reference' => 'ref',
'customerEmails' => [
'customer.user.a@example.com',
'customer.user.b@example.com'
],
'customerLegalCompanyName' => 'Facebook',
'customerBillingAddress' => [
'line1' => 'Flat 1',
'line2' => '15 Yemen Road',
'town' => 'Yemen',
'state' => 'CA',
'postcode' => 'YE1 2YE',
'country' => 'YE'
],
'customerShippingAddress' => [
'line1' => '742 Evergreen Terrace',
'town' => 'Springfield',
'state' => 'CA',
'postcode' => '12345',
'country' => 'US'
],
'memo' => 'Thanks',
'paymentOptions' => [
'BANK_TRANSFER'
],
'billingPeriod' => [
'start' => '2022-10-01',
'endInclusive' => '2022-10-30'
],
'customerId' => '61b083e0-1faa-47ca-9aeb-6205da8f6c47',
'metadata' => [
[
'key' => 'example-label',
'value' => 'label-value'
]
],
'creditBalances' => 'Verification 2 credit balance: 7/7 (expiring on 4 May 2023)',
'billingRunId' => '53ff21c8-4872-46c4-83bf-517d54876945',
'accountingDate' => '2022-09-30',
'attachmentAssetIds' => [
'99874519-25ce-46ff-8823-093115aa7222'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu.sequencehq.com/api/invoices"
payload := strings.NewReader("{\n \"billingScheduleId\": \"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95\",\n \"currency\": \"GBP\",\n \"dueDate\": \"2022-09-30\",\n \"purchaseOrderNumber\": \"PO123\",\n \"reference\": \"ref\",\n \"customerEmails\": [\n \"customer.user.a@example.com\",\n \"customer.user.b@example.com\"\n ],\n \"customerLegalCompanyName\": \"Facebook\",\n \"customerBillingAddress\": {\n \"line1\": \"Flat 1\",\n \"line2\": \"15 Yemen Road\",\n \"town\": \"Yemen\",\n \"state\": \"CA\",\n \"postcode\": \"YE1 2YE\",\n \"country\": \"YE\"\n },\n \"customerShippingAddress\": {\n \"line1\": \"742 Evergreen Terrace\",\n \"town\": \"Springfield\",\n \"state\": \"CA\",\n \"postcode\": \"12345\",\n \"country\": \"US\"\n },\n \"memo\": \"Thanks\",\n \"paymentOptions\": [\n \"BANK_TRANSFER\"\n ],\n \"billingPeriod\": {\n \"start\": \"2022-10-01\",\n \"endInclusive\": \"2022-10-30\"\n },\n \"customerId\": \"61b083e0-1faa-47ca-9aeb-6205da8f6c47\",\n \"metadata\": [\n {\n \"key\": \"example-label\",\n \"value\": \"label-value\"\n }\n ],\n \"creditBalances\": \"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)\",\n \"billingRunId\": \"53ff21c8-4872-46c4-83bf-517d54876945\",\n \"accountingDate\": \"2022-09-30\",\n \"attachmentAssetIds\": [\n \"99874519-25ce-46ff-8823-093115aa7222\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu.sequencehq.com/api/invoices")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"billingScheduleId\": \"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95\",\n \"currency\": \"GBP\",\n \"dueDate\": \"2022-09-30\",\n \"purchaseOrderNumber\": \"PO123\",\n \"reference\": \"ref\",\n \"customerEmails\": [\n \"customer.user.a@example.com\",\n \"customer.user.b@example.com\"\n ],\n \"customerLegalCompanyName\": \"Facebook\",\n \"customerBillingAddress\": {\n \"line1\": \"Flat 1\",\n \"line2\": \"15 Yemen Road\",\n \"town\": \"Yemen\",\n \"state\": \"CA\",\n \"postcode\": \"YE1 2YE\",\n \"country\": \"YE\"\n },\n \"customerShippingAddress\": {\n \"line1\": \"742 Evergreen Terrace\",\n \"town\": \"Springfield\",\n \"state\": \"CA\",\n \"postcode\": \"12345\",\n \"country\": \"US\"\n },\n \"memo\": \"Thanks\",\n \"paymentOptions\": [\n \"BANK_TRANSFER\"\n ],\n \"billingPeriod\": {\n \"start\": \"2022-10-01\",\n \"endInclusive\": \"2022-10-30\"\n },\n \"customerId\": \"61b083e0-1faa-47ca-9aeb-6205da8f6c47\",\n \"metadata\": [\n {\n \"key\": \"example-label\",\n \"value\": \"label-value\"\n }\n ],\n \"creditBalances\": \"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)\",\n \"billingRunId\": \"53ff21c8-4872-46c4-83bf-517d54876945\",\n \"accountingDate\": \"2022-09-30\",\n \"attachmentAssetIds\": [\n \"99874519-25ce-46ff-8823-093115aa7222\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.sequencehq.com/api/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"billingScheduleId\": \"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95\",\n \"currency\": \"GBP\",\n \"dueDate\": \"2022-09-30\",\n \"purchaseOrderNumber\": \"PO123\",\n \"reference\": \"ref\",\n \"customerEmails\": [\n \"customer.user.a@example.com\",\n \"customer.user.b@example.com\"\n ],\n \"customerLegalCompanyName\": \"Facebook\",\n \"customerBillingAddress\": {\n \"line1\": \"Flat 1\",\n \"line2\": \"15 Yemen Road\",\n \"town\": \"Yemen\",\n \"state\": \"CA\",\n \"postcode\": \"YE1 2YE\",\n \"country\": \"YE\"\n },\n \"customerShippingAddress\": {\n \"line1\": \"742 Evergreen Terrace\",\n \"town\": \"Springfield\",\n \"state\": \"CA\",\n \"postcode\": \"12345\",\n \"country\": \"US\"\n },\n \"memo\": \"Thanks\",\n \"paymentOptions\": [\n \"BANK_TRANSFER\"\n ],\n \"billingPeriod\": {\n \"start\": \"2022-10-01\",\n \"endInclusive\": \"2022-10-30\"\n },\n \"customerId\": \"61b083e0-1faa-47ca-9aeb-6205da8f6c47\",\n \"metadata\": [\n {\n \"key\": \"example-label\",\n \"value\": \"label-value\"\n }\n ],\n \"creditBalances\": \"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)\",\n \"billingRunId\": \"53ff21c8-4872-46c4-83bf-517d54876945\",\n \"accountingDate\": \"2022-09-30\",\n \"attachmentAssetIds\": [\n \"99874519-25ce-46ff-8823-093115aa7222\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "6cedbb5e-4f77-4217-b8d4-020e7e4d33c9",
"sequenceAccountId": "68233908-402a-43b4-8952-1c2ab0ef0b25",
"billingScheduleId": "fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95",
"billingRunId": "9c5fdd27-1f7a-41e7-ab67-14f65272a853",
"status": "DRAFT",
"currency": "GBP",
"invoiceNumber": "INV00001",
"issueDate": "2022-09-15",
"dueDate": "2022-09-30",
"purchaseOrderNumber": "PO123",
"reference": "ref",
"customerEmails": [
"customer.user.a@example.com",
"customer.user.b@example.com"
],
"customerLegalCompanyName": "Facebook",
"customerBillingAddress": {
"line1": "Flat 1",
"line2": "15 Yemen Road",
"town": "Yemen",
"state": "CA",
"postcode": "YE1 2YE",
"country": "YE"
},
"customerShippingAddress": {
"line1": "742 Evergreen Terrace",
"town": "Springfield",
"state": "CA",
"postcode": "12345",
"country": "US"
},
"memo": "Thanks",
"paymentOptions": [
"BANK_TRANSFER"
],
"billingPeriod": {
"start": "2022-10-01",
"endInclusive": "2022-10-30"
},
"customerId": "61b083e0-1faa-47ca-9aeb-6205da8f6c47",
"totalTax": "2.50",
"netTotal": "51.20",
"grossTotal": "101.23",
"metadata": [
{
"key": "example-label",
"value": "label-value"
}
],
"customerTaxId": "TAX123",
"paymentStatus": "UNPAID",
"createdAt": "2022-10-30T00:00:00Z",
"updatedAt": "2022-10-30T00:00:00Z",
"creditNoteIds": [
"af60cab3-812d-4250-a051-0fb7133a00c7"
],
"linkedServices": [
{
"externalId": "123",
"externalService": "Xero",
"syncTime": "2022-06-28T16:47:00Z",
"externalUrl": "https://invoicing.xero.com/view/85e52542-3e54-4f0d-872b-33bba11a0504"
}
],
"merchantDetails": {
"address": {
"line1": "The White House",
"line2": "1600 Pennsylvania Avenue",
"town": "Washington, D.C.",
"state": "CA",
"postcode": "20500",
"country": "US"
},
"phoneNumber": "0800001066",
"email": "finance@example.com",
"taxId": "TAX60",
"iban": "GB33BUKB20201555555555",
"ukAccountDetails": {
"sortCode": "000000",
"accountNumber": "12345678"
},
"usAchDetails": {
"accountNumber": "12345678",
"accountName": "John Doe",
"bankName": "Chase",
"bankRoutingNumber": "123456789"
},
"usWireDetails": {
"accountNumber": "12345678",
"accountName": "John Doe",
"bankName": "Chase",
"bankRoutingNumber": "123456789",
"swiftCode": "CHASUS33",
"bankAddress": {
"line1": "JP Morgan Chase",
"town": "New York City",
"state": "NY",
"postcode": "10017",
"country": "US"
}
},
"caBankAccountDetails": {
"transitNumber": "123",
"institutionNumber": "12345",
"accountNumber": "1234567"
},
"canadianInternationalDestination": {
"legalName": "John Doe",
"accountNumber": "12345678",
"transitNumber": "12345",
"bankName": "Chase",
"bankAddress": {
"line1": "JP Morgan Chase",
"town": "New York City",
"state": "NY",
"postcode": "10017",
"country": "US"
},
"institutionNumber": "123",
"swiftCode": "CHASUS33",
"intermediaryBank": {
"bankName": "Chase",
"bankAddress": {
"line1": "JP Morgan Chase",
"town": "New York City",
"state": "NY",
"postcode": "10017",
"country": "US"
},
"swiftCode": "CHASUS33",
"routingNumber": "123456789"
}
},
"australianDestination": {
"legalName": "John Doe",
"accountNumber": "12345678",
"swiftCode": "CHASUS33",
"bsb": "123456"
},
"swedishBankgiroDestination": {
"bankgiroNumber": "123-4567",
"accountName": "The Merchant"
},
"logoUrl": "logo",
"legalCompanyName": "The Merchant",
"primaryColour": "#000000",
"customFields": [
{
"key": "example-label",
"value": "label-value"
}
],
"includeBeneficiaryAddressInPaymentDetails": false
},
"creditBalances": "Verification 2 credit balance: 7/7 (expiring on 4 May 2023)",
"dunningStatus": "SCHEDULED",
"accountingDate": "2022-09-30",
"calculatedAt": "2022-09-30T00:00:00Z",
"customerTaxStatus": "TAXED",
"renderSettings": {
"paymentLinkDisplay": "HIDE_PAYMENT_LINK"
},
"isCustomerArchived": false,
"attachmentAssets": [
{
"id": "4b36a61e-425e-4640-aa26-6224c577b613",
"createdBy": "94703530-1293-479b-bd37-ccad42fd9c8b",
"type": "DOCUMENT",
"format": "PDF",
"fileName": "my-document.pdf",
"fileSizeBytes": 12345,
"url": "https://assets.sequencehq.com/6cedbb5e-4f77-4217-b8d4-020e7e4d33c9/documents/4B36A61E-425E-4640-AA26-6224C577B613.pdf",
"createdAt": "2022-06-28T16:47:00Z"
}
],
"balance": "1000.00",
"balanceVersion": 0,
"integrationPaymentStatuses": {
"stripe": "IN_PROGRESS",
"goCardless": "CANCELLED"
},
"appliedCreditNotes": [
{
"id": "8f3a5b1e-0c2d-4e6f-8a9b-1c2d3e4f5a6b",
"creditNoteNumber": "CN00001",
"netTotal": "41.67",
"totalTax": "8.33",
"grossTotal": "50.00",
"lineItems": [
{
"name": "Adjustment",
"netTotal": "41.67",
"grossTotal": "50.00",
"invoiceLineItemIds": [
"2d4f6a8b-1c3e-4f5a-9b7d-8e6f5a4b3c2d"
]
}
]
}
],
"paymentAllocations": [
{
"paymentId": "3f9c1a7d-6b2e-4c8a-9d5f-0e1a2b3c4d5e",
"amount": "50.00",
"allocatedAt": "2022-10-30T00:00:00Z",
"paidAt": "2022-10-29T00:00:00Z",
"origin": "MANUAL"
}
],
"paymentTermDays": 30,
"dueDateSource": "CALCULATED"
}This response has no body data.This response has no body data.This response has no body data.Invoices
Create an invoice
Create a new invoice
POST
/
invoices
Create an invoice
curl --request POST \
--url https://eu.sequencehq.com/api/invoices \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"billingScheduleId": "fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95",
"currency": "GBP",
"dueDate": "2022-09-30",
"purchaseOrderNumber": "PO123",
"reference": "ref",
"customerEmails": [
"customer.user.a@example.com",
"customer.user.b@example.com"
],
"customerLegalCompanyName": "Facebook",
"customerBillingAddress": {
"line1": "Flat 1",
"line2": "15 Yemen Road",
"town": "Yemen",
"state": "CA",
"postcode": "YE1 2YE",
"country": "YE"
},
"customerShippingAddress": {
"line1": "742 Evergreen Terrace",
"town": "Springfield",
"state": "CA",
"postcode": "12345",
"country": "US"
},
"memo": "Thanks",
"paymentOptions": [
"BANK_TRANSFER"
],
"billingPeriod": {
"start": "2022-10-01",
"endInclusive": "2022-10-30"
},
"customerId": "61b083e0-1faa-47ca-9aeb-6205da8f6c47",
"metadata": [
{
"key": "example-label",
"value": "label-value"
}
],
"creditBalances": "Verification 2 credit balance: 7/7 (expiring on 4 May 2023)",
"billingRunId": "53ff21c8-4872-46c4-83bf-517d54876945",
"accountingDate": "2022-09-30",
"attachmentAssetIds": [
"99874519-25ce-46ff-8823-093115aa7222"
]
}
'import requests
url = "https://eu.sequencehq.com/api/invoices"
payload = {
"billingScheduleId": "fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95",
"currency": "GBP",
"dueDate": "2022-09-30",
"purchaseOrderNumber": "PO123",
"reference": "ref",
"customerEmails": ["customer.user.a@example.com", "customer.user.b@example.com"],
"customerLegalCompanyName": "Facebook",
"customerBillingAddress": {
"line1": "Flat 1",
"line2": "15 Yemen Road",
"town": "Yemen",
"state": "CA",
"postcode": "YE1 2YE",
"country": "YE"
},
"customerShippingAddress": {
"line1": "742 Evergreen Terrace",
"town": "Springfield",
"state": "CA",
"postcode": "12345",
"country": "US"
},
"memo": "Thanks",
"paymentOptions": ["BANK_TRANSFER"],
"billingPeriod": {
"start": "2022-10-01",
"endInclusive": "2022-10-30"
},
"customerId": "61b083e0-1faa-47ca-9aeb-6205da8f6c47",
"metadata": [
{
"key": "example-label",
"value": "label-value"
}
],
"creditBalances": "Verification 2 credit balance: 7/7 (expiring on 4 May 2023)",
"billingRunId": "53ff21c8-4872-46c4-83bf-517d54876945",
"accountingDate": "2022-09-30",
"attachmentAssetIds": ["99874519-25ce-46ff-8823-093115aa7222"]
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({
billingScheduleId: 'fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95',
currency: 'GBP',
dueDate: '2022-09-30',
purchaseOrderNumber: 'PO123',
reference: 'ref',
customerEmails: ['customer.user.a@example.com', 'customer.user.b@example.com'],
customerLegalCompanyName: 'Facebook',
customerBillingAddress: {
line1: 'Flat 1',
line2: '15 Yemen Road',
town: 'Yemen',
state: 'CA',
postcode: 'YE1 2YE',
country: 'YE'
},
customerShippingAddress: {
line1: '742 Evergreen Terrace',
town: 'Springfield',
state: 'CA',
postcode: '12345',
country: 'US'
},
memo: 'Thanks',
paymentOptions: ['BANK_TRANSFER'],
billingPeriod: {start: '2022-10-01', endInclusive: '2022-10-30'},
customerId: '61b083e0-1faa-47ca-9aeb-6205da8f6c47',
metadata: [{key: 'example-label', value: 'label-value'}],
creditBalances: 'Verification 2 credit balance: 7/7 (expiring on 4 May 2023)',
billingRunId: '53ff21c8-4872-46c4-83bf-517d54876945',
accountingDate: '2022-09-30',
attachmentAssetIds: ['99874519-25ce-46ff-8823-093115aa7222']
})
};
fetch('https://eu.sequencehq.com/api/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu.sequencehq.com/api/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'billingScheduleId' => 'fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95',
'currency' => 'GBP',
'dueDate' => '2022-09-30',
'purchaseOrderNumber' => 'PO123',
'reference' => 'ref',
'customerEmails' => [
'customer.user.a@example.com',
'customer.user.b@example.com'
],
'customerLegalCompanyName' => 'Facebook',
'customerBillingAddress' => [
'line1' => 'Flat 1',
'line2' => '15 Yemen Road',
'town' => 'Yemen',
'state' => 'CA',
'postcode' => 'YE1 2YE',
'country' => 'YE'
],
'customerShippingAddress' => [
'line1' => '742 Evergreen Terrace',
'town' => 'Springfield',
'state' => 'CA',
'postcode' => '12345',
'country' => 'US'
],
'memo' => 'Thanks',
'paymentOptions' => [
'BANK_TRANSFER'
],
'billingPeriod' => [
'start' => '2022-10-01',
'endInclusive' => '2022-10-30'
],
'customerId' => '61b083e0-1faa-47ca-9aeb-6205da8f6c47',
'metadata' => [
[
'key' => 'example-label',
'value' => 'label-value'
]
],
'creditBalances' => 'Verification 2 credit balance: 7/7 (expiring on 4 May 2023)',
'billingRunId' => '53ff21c8-4872-46c4-83bf-517d54876945',
'accountingDate' => '2022-09-30',
'attachmentAssetIds' => [
'99874519-25ce-46ff-8823-093115aa7222'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu.sequencehq.com/api/invoices"
payload := strings.NewReader("{\n \"billingScheduleId\": \"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95\",\n \"currency\": \"GBP\",\n \"dueDate\": \"2022-09-30\",\n \"purchaseOrderNumber\": \"PO123\",\n \"reference\": \"ref\",\n \"customerEmails\": [\n \"customer.user.a@example.com\",\n \"customer.user.b@example.com\"\n ],\n \"customerLegalCompanyName\": \"Facebook\",\n \"customerBillingAddress\": {\n \"line1\": \"Flat 1\",\n \"line2\": \"15 Yemen Road\",\n \"town\": \"Yemen\",\n \"state\": \"CA\",\n \"postcode\": \"YE1 2YE\",\n \"country\": \"YE\"\n },\n \"customerShippingAddress\": {\n \"line1\": \"742 Evergreen Terrace\",\n \"town\": \"Springfield\",\n \"state\": \"CA\",\n \"postcode\": \"12345\",\n \"country\": \"US\"\n },\n \"memo\": \"Thanks\",\n \"paymentOptions\": [\n \"BANK_TRANSFER\"\n ],\n \"billingPeriod\": {\n \"start\": \"2022-10-01\",\n \"endInclusive\": \"2022-10-30\"\n },\n \"customerId\": \"61b083e0-1faa-47ca-9aeb-6205da8f6c47\",\n \"metadata\": [\n {\n \"key\": \"example-label\",\n \"value\": \"label-value\"\n }\n ],\n \"creditBalances\": \"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)\",\n \"billingRunId\": \"53ff21c8-4872-46c4-83bf-517d54876945\",\n \"accountingDate\": \"2022-09-30\",\n \"attachmentAssetIds\": [\n \"99874519-25ce-46ff-8823-093115aa7222\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu.sequencehq.com/api/invoices")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"billingScheduleId\": \"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95\",\n \"currency\": \"GBP\",\n \"dueDate\": \"2022-09-30\",\n \"purchaseOrderNumber\": \"PO123\",\n \"reference\": \"ref\",\n \"customerEmails\": [\n \"customer.user.a@example.com\",\n \"customer.user.b@example.com\"\n ],\n \"customerLegalCompanyName\": \"Facebook\",\n \"customerBillingAddress\": {\n \"line1\": \"Flat 1\",\n \"line2\": \"15 Yemen Road\",\n \"town\": \"Yemen\",\n \"state\": \"CA\",\n \"postcode\": \"YE1 2YE\",\n \"country\": \"YE\"\n },\n \"customerShippingAddress\": {\n \"line1\": \"742 Evergreen Terrace\",\n \"town\": \"Springfield\",\n \"state\": \"CA\",\n \"postcode\": \"12345\",\n \"country\": \"US\"\n },\n \"memo\": \"Thanks\",\n \"paymentOptions\": [\n \"BANK_TRANSFER\"\n ],\n \"billingPeriod\": {\n \"start\": \"2022-10-01\",\n \"endInclusive\": \"2022-10-30\"\n },\n \"customerId\": \"61b083e0-1faa-47ca-9aeb-6205da8f6c47\",\n \"metadata\": [\n {\n \"key\": \"example-label\",\n \"value\": \"label-value\"\n }\n ],\n \"creditBalances\": \"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)\",\n \"billingRunId\": \"53ff21c8-4872-46c4-83bf-517d54876945\",\n \"accountingDate\": \"2022-09-30\",\n \"attachmentAssetIds\": [\n \"99874519-25ce-46ff-8823-093115aa7222\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.sequencehq.com/api/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"billingScheduleId\": \"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95\",\n \"currency\": \"GBP\",\n \"dueDate\": \"2022-09-30\",\n \"purchaseOrderNumber\": \"PO123\",\n \"reference\": \"ref\",\n \"customerEmails\": [\n \"customer.user.a@example.com\",\n \"customer.user.b@example.com\"\n ],\n \"customerLegalCompanyName\": \"Facebook\",\n \"customerBillingAddress\": {\n \"line1\": \"Flat 1\",\n \"line2\": \"15 Yemen Road\",\n \"town\": \"Yemen\",\n \"state\": \"CA\",\n \"postcode\": \"YE1 2YE\",\n \"country\": \"YE\"\n },\n \"customerShippingAddress\": {\n \"line1\": \"742 Evergreen Terrace\",\n \"town\": \"Springfield\",\n \"state\": \"CA\",\n \"postcode\": \"12345\",\n \"country\": \"US\"\n },\n \"memo\": \"Thanks\",\n \"paymentOptions\": [\n \"BANK_TRANSFER\"\n ],\n \"billingPeriod\": {\n \"start\": \"2022-10-01\",\n \"endInclusive\": \"2022-10-30\"\n },\n \"customerId\": \"61b083e0-1faa-47ca-9aeb-6205da8f6c47\",\n \"metadata\": [\n {\n \"key\": \"example-label\",\n \"value\": \"label-value\"\n }\n ],\n \"creditBalances\": \"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)\",\n \"billingRunId\": \"53ff21c8-4872-46c4-83bf-517d54876945\",\n \"accountingDate\": \"2022-09-30\",\n \"attachmentAssetIds\": [\n \"99874519-25ce-46ff-8823-093115aa7222\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "6cedbb5e-4f77-4217-b8d4-020e7e4d33c9",
"sequenceAccountId": "68233908-402a-43b4-8952-1c2ab0ef0b25",
"billingScheduleId": "fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95",
"billingRunId": "9c5fdd27-1f7a-41e7-ab67-14f65272a853",
"status": "DRAFT",
"currency": "GBP",
"invoiceNumber": "INV00001",
"issueDate": "2022-09-15",
"dueDate": "2022-09-30",
"purchaseOrderNumber": "PO123",
"reference": "ref",
"customerEmails": [
"customer.user.a@example.com",
"customer.user.b@example.com"
],
"customerLegalCompanyName": "Facebook",
"customerBillingAddress": {
"line1": "Flat 1",
"line2": "15 Yemen Road",
"town": "Yemen",
"state": "CA",
"postcode": "YE1 2YE",
"country": "YE"
},
"customerShippingAddress": {
"line1": "742 Evergreen Terrace",
"town": "Springfield",
"state": "CA",
"postcode": "12345",
"country": "US"
},
"memo": "Thanks",
"paymentOptions": [
"BANK_TRANSFER"
],
"billingPeriod": {
"start": "2022-10-01",
"endInclusive": "2022-10-30"
},
"customerId": "61b083e0-1faa-47ca-9aeb-6205da8f6c47",
"totalTax": "2.50",
"netTotal": "51.20",
"grossTotal": "101.23",
"metadata": [
{
"key": "example-label",
"value": "label-value"
}
],
"customerTaxId": "TAX123",
"paymentStatus": "UNPAID",
"createdAt": "2022-10-30T00:00:00Z",
"updatedAt": "2022-10-30T00:00:00Z",
"creditNoteIds": [
"af60cab3-812d-4250-a051-0fb7133a00c7"
],
"linkedServices": [
{
"externalId": "123",
"externalService": "Xero",
"syncTime": "2022-06-28T16:47:00Z",
"externalUrl": "https://invoicing.xero.com/view/85e52542-3e54-4f0d-872b-33bba11a0504"
}
],
"merchantDetails": {
"address": {
"line1": "The White House",
"line2": "1600 Pennsylvania Avenue",
"town": "Washington, D.C.",
"state": "CA",
"postcode": "20500",
"country": "US"
},
"phoneNumber": "0800001066",
"email": "finance@example.com",
"taxId": "TAX60",
"iban": "GB33BUKB20201555555555",
"ukAccountDetails": {
"sortCode": "000000",
"accountNumber": "12345678"
},
"usAchDetails": {
"accountNumber": "12345678",
"accountName": "John Doe",
"bankName": "Chase",
"bankRoutingNumber": "123456789"
},
"usWireDetails": {
"accountNumber": "12345678",
"accountName": "John Doe",
"bankName": "Chase",
"bankRoutingNumber": "123456789",
"swiftCode": "CHASUS33",
"bankAddress": {
"line1": "JP Morgan Chase",
"town": "New York City",
"state": "NY",
"postcode": "10017",
"country": "US"
}
},
"caBankAccountDetails": {
"transitNumber": "123",
"institutionNumber": "12345",
"accountNumber": "1234567"
},
"canadianInternationalDestination": {
"legalName": "John Doe",
"accountNumber": "12345678",
"transitNumber": "12345",
"bankName": "Chase",
"bankAddress": {
"line1": "JP Morgan Chase",
"town": "New York City",
"state": "NY",
"postcode": "10017",
"country": "US"
},
"institutionNumber": "123",
"swiftCode": "CHASUS33",
"intermediaryBank": {
"bankName": "Chase",
"bankAddress": {
"line1": "JP Morgan Chase",
"town": "New York City",
"state": "NY",
"postcode": "10017",
"country": "US"
},
"swiftCode": "CHASUS33",
"routingNumber": "123456789"
}
},
"australianDestination": {
"legalName": "John Doe",
"accountNumber": "12345678",
"swiftCode": "CHASUS33",
"bsb": "123456"
},
"swedishBankgiroDestination": {
"bankgiroNumber": "123-4567",
"accountName": "The Merchant"
},
"logoUrl": "logo",
"legalCompanyName": "The Merchant",
"primaryColour": "#000000",
"customFields": [
{
"key": "example-label",
"value": "label-value"
}
],
"includeBeneficiaryAddressInPaymentDetails": false
},
"creditBalances": "Verification 2 credit balance: 7/7 (expiring on 4 May 2023)",
"dunningStatus": "SCHEDULED",
"accountingDate": "2022-09-30",
"calculatedAt": "2022-09-30T00:00:00Z",
"customerTaxStatus": "TAXED",
"renderSettings": {
"paymentLinkDisplay": "HIDE_PAYMENT_LINK"
},
"isCustomerArchived": false,
"attachmentAssets": [
{
"id": "4b36a61e-425e-4640-aa26-6224c577b613",
"createdBy": "94703530-1293-479b-bd37-ccad42fd9c8b",
"type": "DOCUMENT",
"format": "PDF",
"fileName": "my-document.pdf",
"fileSizeBytes": 12345,
"url": "https://assets.sequencehq.com/6cedbb5e-4f77-4217-b8d4-020e7e4d33c9/documents/4B36A61E-425E-4640-AA26-6224C577B613.pdf",
"createdAt": "2022-06-28T16:47:00Z"
}
],
"balance": "1000.00",
"balanceVersion": 0,
"integrationPaymentStatuses": {
"stripe": "IN_PROGRESS",
"goCardless": "CANCELLED"
},
"appliedCreditNotes": [
{
"id": "8f3a5b1e-0c2d-4e6f-8a9b-1c2d3e4f5a6b",
"creditNoteNumber": "CN00001",
"netTotal": "41.67",
"totalTax": "8.33",
"grossTotal": "50.00",
"lineItems": [
{
"name": "Adjustment",
"netTotal": "41.67",
"grossTotal": "50.00",
"invoiceLineItemIds": [
"2d4f6a8b-1c3e-4f5a-9b7d-8e6f5a4b3c2d"
]
}
]
}
],
"paymentAllocations": [
{
"paymentId": "3f9c1a7d-6b2e-4c8a-9d5f-0e1a2b3c4d5e",
"amount": "50.00",
"allocatedAt": "2022-10-30T00:00:00Z",
"paidAt": "2022-10-29T00:00:00Z",
"origin": "MANUAL"
}
],
"paymentTermDays": 30,
"dueDateSource": "CALCULATED"
}This response has no body data.This response has no body data.This response has no body data.Headers
Your API credentials. Eg. Basic {credentials}.
Use this header to select an API version
Available options:
2024-07-30 Body
application/json
Invoice currency
Available options:
AED, ARS, AUD, BRL, BGN, CAD, CHF, CLP, CNY, COP, CZK, DKK, EGP, EUR, GBP, HKD, ILS, INR, ISK, JPY, KRW, MXN, NOK, NZD, PLN, SAR, SEK, SGD, THB, USD, UYU, ZAR Example:
"GBP"
The ID of the Customer this invoice is linked to
Example:
"61b083e0-1faa-47ca-9aeb-6205da8f6c47"
Billing Schedule ID
Example:
"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95"
Due date
Example:
"2022-09-30"
Purchase order number
Example:
"PO123"
Reference
Example:
"ref"
Customer email addresses, used for sending the Invoice if provided
Example:
[ "customer.user.a@example.com", "customer.user.b@example.com" ]
Customer's legal company name
Example:
"Facebook"
Customer's billing address
Show child attributes
Show child attributes
Example:
{ "line1": "Flat 1", "line2": "15 Yemen Road", "town": "Yemen", "state": "CA", "postcode": "YE1 2YE", "country": "YE" }
Customer's billing address
Show child attributes
Show child attributes
Example:
{ "line1": "Flat 1", "line2": "15 Yemen Road", "town": "Yemen", "state": "CA", "postcode": "YE1 2YE", "country": "YE" }
Invoice memo
Example:
"Thanks"
Invoice payment options
Available options:
BANK_TRANSFER, LINK Example:
["BANK_TRANSFER"]
Billing period
Show child attributes
Show child attributes
Example:
{ "start": "2022-10-01", "endInclusive": "2022-10-30" }
Mapping of key-value pairs to attach to the Invoice. These are not interpreted by Sequence; they are present for your use alone.
Show child attributes
Show child attributes
Example:
[ { "key": "example-label", "value": "label-value" } ]
Credit balances
Example:
"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)"
Billing Run ID
Example:
"53ff21c8-4872-46c4-83bf-517d54876945"
Accounting date
Example:
"2022-09-30"
Attachment asset IDs
Example:
["99874519-25ce-46ff-8823-093115aa7222"]
Response
Created
Invoice ID
Example:
"6cedbb5e-4f77-4217-b8d4-020e7e4d33c9"
Sequence Account ID
Example:
"68233908-402a-43b4-8952-1c2ab0ef0b25"
Invoice status
Available options:
IN_PROGRESS, DRAFT, FINAL, SENT, VOIDED Example:
"SENT"
Invoice currency
Available options:
AED, ARS, AUD, BRL, BGN, CAD, CHF, CLP, CNY, COP, CZK, DKK, EGP, EUR, GBP, HKD, ILS, INR, ISK, JPY, KRW, MXN, NOK, NZD, PLN, SAR, SEK, SGD, THB, USD, UYU, ZAR Example:
"GBP"
Customer email addresses, used for sending the Invoice if provided
Example:
[ "customer.user.a@example.com", "customer.user.b@example.com" ]
Customer's legal company name
Example:
"Facebook"
Customer's billing address
Show child attributes
Show child attributes
Example:
{ "line1": "Flat 1", "line2": "15 Yemen Road", "town": "Yemen", "state": "CA", "postcode": "YE1 2YE", "country": "YE" }
Customer's billing address
Show child attributes
Show child attributes
Example:
{ "line1": "Flat 1", "line2": "15 Yemen Road", "town": "Yemen", "state": "CA", "postcode": "YE1 2YE", "country": "YE" }
The ID of the Customer this invoice is linked to
Example:
"61b083e0-1faa-47ca-9aeb-6205da8f6c47"
Total tax, in decimal format of the Invoice's currency
Example:
"2.50"
Net total, in decimal format of the Invoice's currency
Example:
"51.20"
Gross total, in decimal format of the Invoice's currency
Example:
"101.23"
Mapping of key-value pairs to attach to the Invoice. These are not interpreted by Sequence; they are present for your use alone.
Show child attributes
Show child attributes
Example:
[ { "key": "example-label", "value": "label-value" } ]
Invoice payment status
Available options:
UNPAID, PARTIALLY_PAID, PAID, UNCOLLECTIBLE Example:
"UNPAID"
Creation time
Example:
"2022-10-30T00:00:00Z"
Updated time
Example:
"2022-10-30T00:00:00Z"
IDs of linked credit notes (if any)
Example:
["af60cab3-812d-4250-a051-0fb7133a00c7"]
External services which are linked to this invoice
Show child attributes
Show child attributes
Example:
[ { "externalId": "123", "externalService": "Xero", "syncTime": "2022-06-28T16:47:00Z", "externalUrl": "https://invoicing.xero.com/view/85e52542-3e54-4f0d-872b-33bba11a0504" } ]
Accounting date
Example:
"2022-09-30"
Settings that control how the invoice is rendered.
Show child attributes
Show child attributes
Example:
{ "paymentLinkDisplay": "HIDE_PAYMENT_LINK" }
isCustomerArchived
Example:
false
Payment or sync status per integration service
Show child attributes
Show child attributes
Example:
{ "stripe": "IN_PROGRESS", "goCardless": "CANCELLED" }
Credit notes applied to this invoice, with per-credit-note totals and line items
Show child attributes
Show child attributes
Example:
[ { "id": "8f3a5b1e-0c2d-4e6f-8a9b-1c2d3e4f5a6b", "creditNoteNumber": "CN00001", "netTotal": "41.67", "totalTax": "8.33", "grossTotal": "50.00", "lineItems": [ { "name": "Adjustment", "netTotal": "41.67", "grossTotal": "50.00", "invoiceLineItemIds": ["2d4f6a8b-1c3e-4f5a-9b7d-8e6f5a4b3c2d"] } ] } ]
Payments allocated to this invoice, with per-payment amounts and dates
Show child attributes
Show child attributes
Example:
[ { "paymentId": "3f9c1a7d-6b2e-4c8a-9d5f-0e1a2b3c4d5e", "amount": "50.00", "allocatedAt": "2022-10-30T00:00:00Z", "paidAt": "2022-10-29T00:00:00Z", "origin": "MANUAL" } ]
How the due date was determined: MANUAL when set to a fixed date, CALCULATED when computed from payment terms.
Available options:
MANUAL, CALCULATED Example:
"CALCULATED"
Billing Schedule ID
Example:
"fe2fcd0b-4c53-45c7-b2ae-b6c1a7d21e95"
Billing Run ID
Example:
"9c5fdd27-1f7a-41e7-ab67-14f65272a853"
Invoice number
Example:
"INV00001"
Issue date
Example:
"2022-09-15"
Due date
Example:
"2022-09-30"
Purchase order number
Example:
"PO123"
Reference
Example:
"ref"
Invoice memo
Example:
"Thanks"
Invoice payment options
Available options:
BANK_TRANSFER, LINK Example:
["BANK_TRANSFER"]
Billing period
Show child attributes
Show child attributes
Example:
{ "start": "2022-10-01", "endInclusive": "2022-10-30" }
Customer's tax ID
Example:
"TAX123"
Merchant details
Show child attributes
Show child attributes
Example:
{ "address": { "line1": "Flat 1", "line2": "123 Fake Street", "town": "New York", "state": "NY", "postcode": "AB1 2EF", "country": "US" }, "phoneNumber": "0800001066", "email": "donald@example.com", "taxId": "TAX", "iban": "GB33BUKB20201555555555", "ukAccountDetails": { "sortCode": "123456", "accountNumber": "12345678" }, "usAchDetails": { "accountNumber": "12345678", "accountName": "John Doe", "bankName": "Chase", "bankRoutingNumber": "123456789" }, "usWireDetails": { "accountNumber": "12345678", "accountName": "John Doe", "bankName": "Chase", "bankRoutingNumber": "123456789", "swiftCode": "CHASUS33", "bankAddress": { "line1": "JP Morgan Chase", "town": "New York City", "state": "NY", "postcode": "10017", "country": "US" } }, "swedishBankgiroDestination": { "bankgiroNumber": "123-4567", "accountName": "The Merchant" }, "legalCompanyName": "The Merchant", "customFields": [], "includeBeneficiaryAddressInPaymentDetails": false }
Credit balances
Example:
"Verification 2 credit balance: 7/7 (expiring on 4 May 2023)"
Dunning status
Available options:
SCHEDULED, OVERDUE_CHECK_SCHEDULED, COMPLETED, FAILED, NOT_REQUIRED Example:
"SCHEDULED"
Time this invoice was last calculated (applicable for invoices generated by billing engine only)
Example:
"2022-09-30T00:00:00Z"
Customer tax status
Available options:
TAXED, TAX_EXEMPT, REVERSE_CHARGED Example:
"TAXED"
Assets attached to this invoice
Show child attributes
Show child attributes
Example:
[ { "id": "4b36a61e-425e-4640-aa26-6224c577b613", "createdBy": "94703530-1293-479b-bd37-ccad42fd9c8b", "type": "DOCUMENT", "format": "PDF", "fileName": "my-document.pdf", "fileSizeBytes": 12345, "url": "https://assets.sequencehq.com/6cedbb5e-4f77-4217-b8d4-020e7e4d33c9/documents/4B36A61E-425E-4640-AA26-6224C577B613.pdf", "createdAt": "2022-06-28T16:47:00Z" } ]
Outstanding amount owed on this invoice
Example:
"1000.00"
Ledger version of the balance. Advances each time the balance changes; null when the invoice has no ledger balance.
Example:
0
Payment terms in days. The due date is computed from these terms.
Example:
30
⌘I