List available expenses
curl --request GET \
--url https://api.altera.co/expenses \
--header 'Authorization: <api-key>'import requests
url = "https://api.altera.co/expenses"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.altera.co/expenses', 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://api.altera.co/expenses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.altera.co/expenses"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.altera.co/expenses")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.altera.co/expenses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"result": "OK",
"data": {
"expenses": [
{
"modelType": "PROCESSED_EXPENSE",
"readOnly": false,
"basicInformation": {
"invoiceId": 18,
"invoiceType": "SALES",
"invoiceNumber": "2/1/2022",
"year": 2022,
"month": 6,
"invoiceNumberInPeriod": 2,
"statusId": "SENT",
"isReceipt": false,
"isRelated": false,
"netPrice": 8500,
"grossPrice": 10455,
"currency": "PLN",
"exchangeRate": 1,
"vatPLN": 1955,
"issueDate": "2022-06-16T00:00:00.000Z",
"saleDate": "2022-06-27T00:00:00.000Z",
"uploadDate": "2022-03-24T14:26:17.000Z",
"relatedInvoicesIds": [],
"priceTypeId": "NET",
"paymentGenerationStatus": "ACCEPTED"
},
"contractor": {
"contractorName": "Altera sp. z o.o.",
"contractorId": 25,
"taxIdentificationNumber": "7010978165",
"country": "PL",
"contractorType": "COMPANY",
"contractorRegion": "POLAND",
"defaultCurrency": "PLN",
"city": "Bydgoszcz",
"street": "ul. Grunwaldzka",
"houseNumber": "4",
"postCode": "85-236"
},
"buyer": {
"taxIdentificationNumber": "9671391067",
"contractorName": "ITKO Łukasz Kowalski"
},
"seller": {
"contractorName": "Altera sp. z o.o.",
"contractorId": 25,
"taxIdentificationNumber": "7010978165",
"country": "PL",
"contractorType": "COMPANY",
"contractorRegion": "POLAND",
"defaultCurrency": "PLN",
"city": "Bydgoszcz",
"street": "ul. Grunwaldzka",
"houseNumber": "4",
"postCode": "85-236"
},
"payments": {
"paymentMethod": "TRANSFER",
"dueDate": "2022-07-11T00:00:00.000Z",
"isSplitPayment": false,
"isPaid": false,
"bankAccountNumber": "PL78114020040000360280396856"
},
"invoicePosition": [],
"costCenterPerItem": false,
"additionalDetails": "Usługi księgowe Koszty ogólne",
"accounting": {
"accountingDate": "2022-09-16T00:00:00.000Z",
"receiptDate": "2022-09-23T00:00:00.000Z",
"vatProcedures": [],
"registrationPlate": "",
"isSubjectToVat": false,
"activeVat": false,
"bufferOnly": false
}
}
],
"pagesAmount": "1",
"sumGross": "10455.000",
"sumNet": "8500.00"
}
}Expenses
List available expenses
Gets a list of expense invoices imported into the system for your company.
GET
/
expenses
List available expenses
curl --request GET \
--url https://api.altera.co/expenses \
--header 'Authorization: <api-key>'import requests
url = "https://api.altera.co/expenses"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.altera.co/expenses', 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://api.altera.co/expenses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.altera.co/expenses"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.altera.co/expenses")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.altera.co/expenses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"result": "OK",
"data": {
"expenses": [
{
"modelType": "PROCESSED_EXPENSE",
"readOnly": false,
"basicInformation": {
"invoiceId": 18,
"invoiceType": "SALES",
"invoiceNumber": "2/1/2022",
"year": 2022,
"month": 6,
"invoiceNumberInPeriod": 2,
"statusId": "SENT",
"isReceipt": false,
"isRelated": false,
"netPrice": 8500,
"grossPrice": 10455,
"currency": "PLN",
"exchangeRate": 1,
"vatPLN": 1955,
"issueDate": "2022-06-16T00:00:00.000Z",
"saleDate": "2022-06-27T00:00:00.000Z",
"uploadDate": "2022-03-24T14:26:17.000Z",
"relatedInvoicesIds": [],
"priceTypeId": "NET",
"paymentGenerationStatus": "ACCEPTED"
},
"contractor": {
"contractorName": "Altera sp. z o.o.",
"contractorId": 25,
"taxIdentificationNumber": "7010978165",
"country": "PL",
"contractorType": "COMPANY",
"contractorRegion": "POLAND",
"defaultCurrency": "PLN",
"city": "Bydgoszcz",
"street": "ul. Grunwaldzka",
"houseNumber": "4",
"postCode": "85-236"
},
"buyer": {
"taxIdentificationNumber": "9671391067",
"contractorName": "ITKO Łukasz Kowalski"
},
"seller": {
"contractorName": "Altera sp. z o.o.",
"contractorId": 25,
"taxIdentificationNumber": "7010978165",
"country": "PL",
"contractorType": "COMPANY",
"contractorRegion": "POLAND",
"defaultCurrency": "PLN",
"city": "Bydgoszcz",
"street": "ul. Grunwaldzka",
"houseNumber": "4",
"postCode": "85-236"
},
"payments": {
"paymentMethod": "TRANSFER",
"dueDate": "2022-07-11T00:00:00.000Z",
"isSplitPayment": false,
"isPaid": false,
"bankAccountNumber": "PL78114020040000360280396856"
},
"invoicePosition": [],
"costCenterPerItem": false,
"additionalDetails": "Usługi księgowe Koszty ogólne",
"accounting": {
"accountingDate": "2022-09-16T00:00:00.000Z",
"receiptDate": "2022-09-23T00:00:00.000Z",
"vatProcedures": [],
"registrationPlate": "",
"isSubjectToVat": false,
"activeVat": false,
"bufferOnly": false
}
}
],
"pagesAmount": "1",
"sumGross": "10455.000",
"sumNet": "8500.00"
}
}Authorizations
OpenApi Key created within Altera.app for a certain company
Query Parameters
Defines the amount of invoices polled per page
Available options:
10, 20, 50, 100 Defines the page we want to poll
Available options:
INVOICE_NUMBER, ISSUE_DATE, SALE_DATE, DUE_DATE, AMOUNT_GROSS, CONTRACTOR_NAME Example:
"ISSUE_DATE"
Available options:
ASC, DESC Example:
"DESC"
Freetext search over concatenated fields InvoiceNumber, ContractorName, ContractorTIN and ContractorCity
Example:
"INTERIM"
Available options:
PAID, UNPAID, OVERDUE Example:
"OVERDUE"
Was this page helpful?
⌘I

