Upload a receipt

POST

receipts

Upload a receipt

curl --request POST \
  --url https://api.infinity.swiss/v1/receipts \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-token: <api-key>' \
  --form file='@example-file' \
  --form 'title=Coffee receipt 2025-01-30' \
  --form 'note=<string>' \
  --form transactionId=682338d9e9500b3ffe4baa5a

import requests

url = "https://api.infinity.swiss/v1/receipts"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = {
    "title": "Coffee receipt 2025-01-30",
    "note": "<string>",
    "transactionId": "682338d9e9500b3ffe4baa5a"
}
headers = {"x-api-token": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('title', 'Coffee receipt 2025-01-30');
form.append('note', '<string>');
form.append('transactionId', '682338d9e9500b3ffe4baa5a');

const options = {method: 'POST', headers: {'x-api-token': '<api-key>'}};

options.body = form;

fetch('https://api.infinity.swiss/v1/receipts', 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.infinity.swiss/v1/receipts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "x-api-token: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/receipts"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.infinity.swiss/v1/receipts")
  .header("x-api-token", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/receipts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "receipt": {
    "id": "686f1b2ce9500b3ffe4bbc71",
    "title": "Coffee receipt 2025-01-30",
    "uploadedAt": "2025-01-30T12:00:00.000Z",
    "note": "<string>",
    "transactionId": "682338d9e9500b3ffe4baa5a",
    "analysisStatus": "<string>"
  }
}

{
  "code": "<string>",
  "invalidFields": [
    "title"
  ]
}

{
  "code": "general/unauthorised"
}

{
  "code": "<string>"
}

{
  "code": "<string>"
}

{
  "code": "<string>",
  "supportedTypes": [
    "application/pdf"
  ]
}

{
  "code": "<string>"
}

Uploading a receipt

Send the request as multipart/form-data with the file contents in the file field. For example, the following request uploads a receipt PDF and attaches it to an existing ledger entry:

curl -X POST https://api.infinity.swiss/v1/receipts \
  -H "x-api-token: your-api-token" \
  -F "file=@receipt.pdf" \
  -F "title=Coffee receipt 2025-01-30" \
  -F "note=Team breakfast" \
  -F "transactionId=682338d9e9500b3ffe4baa5a"

If transactionId is omitted, the document lands in the organisation’s document inbox, where it can be processed later — just like a manual upload in the app.

Supported file types

Files can be at most 10 MB in size, and must be one of the following types:

Content type	Format
`application/pdf`	PDF documents
`image/png`	PNG images
`image/jpeg`	JPEG images
`image/gif`	GIF images
`image/tiff`	TIFF images
`image/heic`	HEIC images
`image/heif`	HEIF images

The actual contents of the uploaded file are validated. Files whose content does not match one of the supported types are rejected with a 415 Unsupported Media Type response and the error code files/unsupported-file-type, even if a supported content type or file extension is claimed in the request.

Live Capture analysis

If Live Capture is enabled for the organisation and analysis quota is available, an automatic document analysis starts after the upload, similar to uploading a receipt manually in the app. The analysis runs in the background and does not delay the response. To skip the automatic analysis for an upload, set the suppressAnalysis field to true.

Rate limits

Because uploads are materially more expensive to process than other requests, this endpoint has a stricter rate limit than the rest of the API: at most 100 requests per hour. When the limit is exceeded, you’ll receive a 429 Too Many Requests response with error code general/too-many-requests. Uploads are also processed in a background queue, so bursts of uploads within the rate limit (for example, an automation submitting dozens of receipts in a short window) are handled gracefully. Analyses from a large batch are processed a few at a time, so it can take several minutes until every document in the batch has finished analysing.

Authorizations

x-api-token

string

header

required

API token for authentication. Obtain from your Infinity account settings.

Body

multipart/form-data

The receipt file and its metadata as multipart/form-data.

file

required

The file to upload (maximum 10 MB). Supported content types:

application/pdf
image/png
image/jpeg
image/gif
image/tiff
image/heic
image/heif

The actual file content is validated, so the file must really be one of these types regardless of the declared content type or file extension.

title

string

required

A title or file name for the document.

Maximum string length: 200

Example:

"Coffee receipt 2025-01-30"

note

string

An optional note to store with the document.

Maximum string length: 1000

transactionId

string

The id of an existing ledger entry transaction to attach the receipt to. If set, the document is filed to the receipts location. If unset, the document lands in the inbox.

Example:

"682338d9e9500b3ffe4baa5a"

suppressAnalysis

enum<string>

If true, no automatic Live Capture document analysis is started for this upload. By default, analysis starts after upload if Live Capture is enabled for the organisation and analysis quota is available.

Available options:

true,

false

Response

The receipt was uploaded successfully.

receipt

Receipt · object

required

A receipt document that was uploaded to the organisation.

Show child attributes

Find contactsFinds any matching contacts in the organisation.

Upload a receipt

curl --request POST \
  --url https://api.infinity.swiss/v1/receipts \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-token: <api-key>' \
  --form file='@example-file' \
  --form 'title=Coffee receipt 2025-01-30' \
  --form 'note=<string>' \
  --form transactionId=682338d9e9500b3ffe4baa5a

import requests

url = "https://api.infinity.swiss/v1/receipts"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = {
    "title": "Coffee receipt 2025-01-30",
    "note": "<string>",
    "transactionId": "682338d9e9500b3ffe4baa5a"
}
headers = {"x-api-token": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('title', 'Coffee receipt 2025-01-30');
form.append('note', '<string>');
form.append('transactionId', '682338d9e9500b3ffe4baa5a');

const options = {method: 'POST', headers: {'x-api-token': '<api-key>'}};

options.body = form;

fetch('https://api.infinity.swiss/v1/receipts', 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.infinity.swiss/v1/receipts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "x-api-token: <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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/receipts"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.infinity.swiss/v1/receipts")
  .header("x-api-token", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/receipts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\nCoffee receipt 2025-01-30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transactionId\"\r\n\r\n682338d9e9500b3ffe4baa5a\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "receipt": {
    "id": "686f1b2ce9500b3ffe4bbc71",
    "title": "Coffee receipt 2025-01-30",
    "uploadedAt": "2025-01-30T12:00:00.000Z",
    "note": "<string>",
    "transactionId": "682338d9e9500b3ffe4baa5a",
    "analysisStatus": "<string>"
  }
}

{
  "code": "<string>",
  "invalidFields": [
    "title"
  ]
}

{
  "code": "general/unauthorised"
}

{
  "code": "<string>"
}

{
  "code": "<string>"
}

{
  "code": "<string>",
  "supportedTypes": [
    "application/pdf"
  ]
}

{
  "code": "<string>"
}

For developers

Accounting

Receipts

Contacts

Invoices

Estimates

Uploading a receipt

Supported file types

Live Capture analysis

Rate limits

Authorizations

Body

Response

​Uploading a receipt

​Supported file types

​Live Capture analysis

​Rate limits

Authorizations

Body

Response

Uploading a receipt

Supported file types

Live Capture analysis

Rate limits