Invoices

Create invoice

Records an invoice the company already sent and books its revenue: Accounts Receivable for the total and revenue per line item, spread over spread_months when set. It starts open and becomes paid when a deposit is matched to it. Tax is booked as a liability, not revenue. The total must be more than 0, and dates in a tax year the company has finished with Finta are refused (closed_books).

Retrying is safe without an Idempotency-Key: a non-voided invoice with the same customer name (ignoring case and surrounding spaces), date and total returns 409 invoice_already_exists naming it, and creates nothing. Requires Invoices: Manage.

POST

invoices

Create invoice

curl --request POST \
  --url https://app.finta.com/api/v1/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_name": "Acme Corp",
  "invoice_date": "2026-09-01",
  "line_items": [
    {
      "description": "Annual license",
      "amount_cents": 1200000,
      "category_id": "cat_r1a2b3c4d5e6f7",
      "spread_months": 12
    }
  ],
  "adjustments": [
    {
      "kind": "discount",
      "amount_cents": 100000,
      "description": "Launch discount"
    }
  ]
}
'

import requests

url = "https://app.finta.com/api/v1/invoices"

payload = {
    "customer_name": "Acme Corp",
    "invoice_date": "2026-09-01",
    "line_items": [
        {
            "description": "Annual license",
            "amount_cents": 1200000,
            "category_id": "cat_r1a2b3c4d5e6f7",
            "spread_months": 12
        }
    ],
    "adjustments": [
        {
            "kind": "discount",
            "amount_cents": 100000,
            "description": "Launch discount"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customer_name: 'Acme Corp',
    invoice_date: '2026-09-01',
    line_items: [
      {
        description: 'Annual license',
        amount_cents: 1200000,
        category_id: 'cat_r1a2b3c4d5e6f7',
        spread_months: 12
      }
    ],
    adjustments: [{kind: 'discount', amount_cents: 100000, description: 'Launch discount'}]
  })
};

fetch('https://app.finta.com/api/v1/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://app.finta.com/api/v1/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([
    'customer_name' => 'Acme Corp',
    'invoice_date' => '2026-09-01',
    'line_items' => [
        [
                'description' => 'Annual license',
                'amount_cents' => 1200000,
                'category_id' => 'cat_r1a2b3c4d5e6f7',
                'spread_months' => 12
        ]
    ],
    'adjustments' => [
        [
                'kind' => 'discount',
                'amount_cents' => 100000,
                'description' => 'Launch discount'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://app.finta.com/api/v1/invoices"

	payload := strings.NewReader("{\n  \"customer_name\": \"Acme Corp\",\n  \"invoice_date\": \"2026-09-01\",\n  \"line_items\": [\n    {\n      \"description\": \"Annual license\",\n      \"amount_cents\": 1200000,\n      \"category_id\": \"cat_r1a2b3c4d5e6f7\",\n      \"spread_months\": 12\n    }\n  ],\n  \"adjustments\": [\n    {\n      \"kind\": \"discount\",\n      \"amount_cents\": 100000,\n      \"description\": \"Launch discount\"\n    }\n  ]\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://app.finta.com/api/v1/invoices")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customer_name\": \"Acme Corp\",\n  \"invoice_date\": \"2026-09-01\",\n  \"line_items\": [\n    {\n      \"description\": \"Annual license\",\n      \"amount_cents\": 1200000,\n      \"category_id\": \"cat_r1a2b3c4d5e6f7\",\n      \"spread_months\": 12\n    }\n  ],\n  \"adjustments\": [\n    {\n      \"kind\": \"discount\",\n      \"amount_cents\": 100000,\n      \"description\": \"Launch discount\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/invoices")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customer_name\": \"Acme Corp\",\n  \"invoice_date\": \"2026-09-01\",\n  \"line_items\": [\n    {\n      \"description\": \"Annual license\",\n      \"amount_cents\": 1200000,\n      \"category_id\": \"cat_r1a2b3c4d5e6f7\",\n      \"spread_months\": 12\n    }\n  ],\n  \"adjustments\": [\n    {\n      \"kind\": \"discount\",\n      \"amount_cents\": 100000,\n      \"description\": \"Launch discount\"\n    }\n  ]\n}"

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

{
  "id": "inv_k3m9p2q8r4s7t1",
  "object": "invoice",
  "status": "open",
  "customer_name": "Acme Corp",
  "invoice_date": "2026-09-01",
  "amount_cents": 1100000,
  "currency": "USD",
  "line_items": [
    {
      "description": "Annual license",
      "amount_cents": 1200000,
      "category_id": "cat_r1a2b3c4d5e6f7",
      "category_name": "Subscription Revenue",
      "spread_months": 12
    }
  ],
  "adjustments": [
    {
      "kind": "discount",
      "amount_cents": 100000,
      "description": "<string>"
    }
  ],
  "paid_transaction_id": "txn_a1b2c3d4e5f6g7",
  "paid_date": "2023-12-25",
  "source": "manual",
  "stripe_url": "<string>",
  "created": 1788220800
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Body

application/json

customer_name

string

required

Minimum string length: 1

invoice_date

string<date>

required

The date the invoice was issued, as YYYY-MM-DD.

line_items

object[]

required

Required array length: 1 - 10 elements

Show child attributes

adjustments

object[]

Each kind at most once.

Show child attributes

Response

The invoice was recorded

An invoice the company sent, with the revenue it booked and the deposit that paid it.

string

required

Example:

"inv_k3m9p2q8r4s7t1"

object

enum<string>

required

Available options:

invoice

status

enum<string>

required

open until a deposit is matched as its payment, then paid. voided invoices booked nothing.

Available options:

open,

paid,

voided

customer_name

string

required

Example:

"Acme Corp"

invoice_date

string<date>

required

Example:

"2026-09-01"

amount_cents

integer

required

The total due in cents, after discounts, credits and tax.

Example:

1100000

currency

string

required

Example:

"USD"

line_items

object[]

required

Every line item, in order. At most 10 on invoices created in Finta or through the API; invoices recorded from Stripe can have more.

Show child attributes

adjustments

object[]

required

Discounts, customer balance credits and tax, at most one of each kind.

Show child attributes

paid_transaction_id

string | null

required

The bank deposit matched as this invoice's payment. Null unless paid. It stays set even if that transaction is later deleted in Finta, so it may not be retrievable with GET /transactions/{id}.

Example:

"txn_a1b2c3d4e5f6g7"

paid_date

string<date> | null

required

The date of the matched deposit. Null unless paid.

source

enum<string>

required

stripe when Finta recorded the invoice from the company's Stripe account; manual when it was entered in Finta or through the API.

Available options:

manual,

stripe

stripe_url

string | null

required

The invoice in the Stripe dashboard, for Stripe invoices.

created

integer

required

When the invoice was recorded in Finta, as a Unix timestamp.

Example:

1788220800

Create invoice

curl --request POST \
  --url https://app.finta.com/api/v1/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_name": "Acme Corp",
  "invoice_date": "2026-09-01",
  "line_items": [
    {
      "description": "Annual license",
      "amount_cents": 1200000,
      "category_id": "cat_r1a2b3c4d5e6f7",
      "spread_months": 12
    }
  ],
  "adjustments": [
    {
      "kind": "discount",
      "amount_cents": 100000,
      "description": "Launch discount"
    }
  ]
}
'

import requests

url = "https://app.finta.com/api/v1/invoices"

payload = {
    "customer_name": "Acme Corp",
    "invoice_date": "2026-09-01",
    "line_items": [
        {
            "description": "Annual license",
            "amount_cents": 1200000,
            "category_id": "cat_r1a2b3c4d5e6f7",
            "spread_months": 12
        }
    ],
    "adjustments": [
        {
            "kind": "discount",
            "amount_cents": 100000,
            "description": "Launch discount"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customer_name: 'Acme Corp',
    invoice_date: '2026-09-01',
    line_items: [
      {
        description: 'Annual license',
        amount_cents: 1200000,
        category_id: 'cat_r1a2b3c4d5e6f7',
        spread_months: 12
      }
    ],
    adjustments: [{kind: 'discount', amount_cents: 100000, description: 'Launch discount'}]
  })
};

fetch('https://app.finta.com/api/v1/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://app.finta.com/api/v1/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([
    'customer_name' => 'Acme Corp',
    'invoice_date' => '2026-09-01',
    'line_items' => [
        [
                'description' => 'Annual license',
                'amount_cents' => 1200000,
                'category_id' => 'cat_r1a2b3c4d5e6f7',
                'spread_months' => 12
        ]
    ],
    'adjustments' => [
        [
                'kind' => 'discount',
                'amount_cents' => 100000,
                'description' => 'Launch discount'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://app.finta.com/api/v1/invoices"

	payload := strings.NewReader("{\n  \"customer_name\": \"Acme Corp\",\n  \"invoice_date\": \"2026-09-01\",\n  \"line_items\": [\n    {\n      \"description\": \"Annual license\",\n      \"amount_cents\": 1200000,\n      \"category_id\": \"cat_r1a2b3c4d5e6f7\",\n      \"spread_months\": 12\n    }\n  ],\n  \"adjustments\": [\n    {\n      \"kind\": \"discount\",\n      \"amount_cents\": 100000,\n      \"description\": \"Launch discount\"\n    }\n  ]\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://app.finta.com/api/v1/invoices")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customer_name\": \"Acme Corp\",\n  \"invoice_date\": \"2026-09-01\",\n  \"line_items\": [\n    {\n      \"description\": \"Annual license\",\n      \"amount_cents\": 1200000,\n      \"category_id\": \"cat_r1a2b3c4d5e6f7\",\n      \"spread_months\": 12\n    }\n  ],\n  \"adjustments\": [\n    {\n      \"kind\": \"discount\",\n      \"amount_cents\": 100000,\n      \"description\": \"Launch discount\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/invoices")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customer_name\": \"Acme Corp\",\n  \"invoice_date\": \"2026-09-01\",\n  \"line_items\": [\n    {\n      \"description\": \"Annual license\",\n      \"amount_cents\": 1200000,\n      \"category_id\": \"cat_r1a2b3c4d5e6f7\",\n      \"spread_months\": 12\n    }\n  ],\n  \"adjustments\": [\n    {\n      \"kind\": \"discount\",\n      \"amount_cents\": 100000,\n      \"description\": \"Launch discount\"\n    }\n  ]\n}"

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

{
  "id": "inv_k3m9p2q8r4s7t1",
  "object": "invoice",
  "status": "open",
  "customer_name": "Acme Corp",
  "invoice_date": "2026-09-01",
  "amount_cents": 1100000,
  "currency": "USD",
  "line_items": [
    {
      "description": "Annual license",
      "amount_cents": 1200000,
      "category_id": "cat_r1a2b3c4d5e6f7",
      "category_name": "Subscription Revenue",
      "spread_months": 12
    }
  ],
  "adjustments": [
    {
      "kind": "discount",
      "amount_cents": 100000,
      "description": "<string>"
    }
  ],
  "paid_transaction_id": "txn_a1b2c3d4e5f6g7",
  "paid_date": "2023-12-25",
  "source": "manual",
  "stripe_url": "<string>",
  "created": 1788220800
}

API Reference

Taxes

Company

Team

Categories

Rules

Departments

Integrations

Aggregations

Transactions

Forms

Journal Entries

Invoices

Parties

Reports

Feedback

Create invoice

Authorizations

Body

Response