Invoices

List, create and send invoices. Scope: invoices.read / invoices.write. Type is fixed to invoice (no type query).

List invoices

GET /v1/invoices

Paginated list of invoices, by default sorted by invoice date (newest first). Filter on client, number, invoice, due or creation date, payment status or `search`

Authorization: HTTP

type: http

scheme: bearer

Query 15

Name	Type	Description
`page`	integer
`per_page`	integer
`id`	string
`client_id`	string
`number`	string
`date_from`	string
`date_to`	string
`due_date_from`	string
`due_date_to`	string
`created_from`	string
`created_to`	string
`search`	string
`payment_status`	string	Payment status of a document, the same as Appficient shows it: `paid` when the invoice is marked paid, `partial` when payments cover part of it, otherwise the last status from your payment provider (`pending`, `failed`, `canceled`, `expired`, `authorized`, `created`, `chargeback`, `refunded`) or `open`.
`sort`	string	Sort field.
`order`	string	Sort direction.

Request body None

None

Response 2

data array

id string

number string

title string

invoice_date string

due_date string

created_at string

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

client_id string

payment_status string

Payment status of a document, the same as Appficient shows it: `paid` when the invoice is marked paid, `partial` when payments cover part of it, otherwise the last status from your payment provider (`pending`, `failed`, `canceled`, `expired`, `authorized`, `created`, `chargeback`, `refunded`) or `open`.

Enum

open partial paid pending failed canceled expired authorized created chargeback refunded

paid_at string Nullable

sent_at string Nullable

project_number string Nullable

is_credit boolean

external_id string Nullable

Your reference, if set.

meta object

page integer

per_page integer

total integer

pages integer

{
    "data": [
        {
            "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "created_at": "2026-01-31T09:00:00+01:00",
            "due_date": "2026-02-14",
            "external_id": null,
            "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "invoice_date": "2026-01-31",
            "number": "2026-00123",
            "payment_status": "open",
            "subtotal": 1000,
            "title": "Werkzaamheden januari",
            "total_excl_vat": 1000,
            "total_incl_vat": 1210,
            "vat_amount": 210,
            "vat_rate": 21
        }
    ],
    "meta": {
        "page": 1,
        "pages": 1,
        "per_page": 25,
        "total": 1
    }
}

Examples

GET /v1/invoices

curl -X GET "https://api.appficient.nl/v1/invoices" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": [
        {
            "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "created_at": "2026-01-31T09:00:00+01:00",
            "due_date": "2026-02-14",
            "external_id": null,
            "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "invoice_date": "2026-01-31",
            "number": "2026-00123",
            "payment_status": "open",
            "subtotal": 1000,
            "title": "Werkzaamheden januari",
            "total_excl_vat": 1000,
            "total_incl_vat": 1210,
            "vat_amount": 210,
            "vat_rate": 21
        }
    ],
    "meta": {
        "page": 1,
        "pages": 1,
        "per_page": 25,
        "total": 1
    }
}

Curl, Node and response are shown to the right of this endpoint.

Create an invoice

POST /v1/invoices

Creates an invoice with `rows` (name, quantity, unit price, VAT rate). The server calculates the totals

Authorization: HTTP

type: http

scheme: bearer

Headers 1

Name	Type	Description
`Idempotency-Key`	string	Optional. Replay within 24h returns the same response.

Request body 16

title string Required

client_id string

client_external_id string

invoice_date string

due_date string

external_id string

Your unique reference. Duplicate → `409`.

Example: inv-2026-00123

generation_mode string

`draft` (default) or `final`.

Enum

draft final

Example: draft

generate boolean

Shortcut for `final`.

rows array

name string

title string

quantity number

unit_price number

unit string

vat_rate string

VAT for this row — a `code` from `GET /v1/tax-rates` (e.g. `VAT21`, `VATINEU`, `VATNONE`) or a percentage (`21`, `21.00`, `9%`). Empty uses the environment default; an unknown value returns 422.

vat_code string

Alias of `vat_rate`.

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

number string

payment_status string

`paid` registers a payment for the open amount, the same as marking the invoice paid in Appficient. Only on a final invoice; otherwise `422`. Other values record the provider status of an unpaid invoice; on a paid invoice they return `409 invoice_paid`. `partial` is derived from payments and cannot be set; on a partly paid invoice any non-`paid` value is returned as `partial`.

Enum

open paid pending failed canceled expired authorized created chargeback refunded

{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}

Response 2

data object

Document list item.

id string

number string

title string

invoice_date string

due_date string

created_at string

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

client_id string

payment_status string

Enum

open partial paid pending failed canceled expired authorized created chargeback refunded

paid_at string Nullable

sent_at string Nullable

project_number string Nullable

is_credit boolean

external_id string Nullable

Your reference, if set.

rows array

name string

quantity number

unit string

unit_price number

vat_rate string

total_excl_vat number

total_incl_vat number

client_company_name string

client_firstname string

client_lastname string

web_url string

pdf_url string

source_id string Nullable

The document this one was created from (for example the quote of a workorder, or the workorder of an invoice); an invoice, quote, workorder or subscription id. `null` when it was not created from another document, when the source is a template or another document type the API does not return, or when the user may not see the source workorder.

meta object

generation_mode string

`draft` (default) or `final`.

Enum

draft final

Example: draft

pdf object

generated boolean

status string

message string Nullable

url string Nullable

payment_registered boolean

Only when `payment_status` was `paid`. `false` means the invoice was created but the payment could not be registered; its `payment_status` shows the actual state.

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": {
        "generation_mode": "draft"
    }
}

Examples

POST /v1/invoices

curl -X POST "https://api.appficient.nl/v1/invoices" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'

import requests

url = 'https://api.appficient.nl/v1/invoices'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices");
request.Content = new StringContent(
    "{\"client_id\":\"00000000-0000-0000-0000-000000000001\",\"title\":\"Draft invoice\",\"generation_mode\":\"draft\"}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"client_id\":\"00000000-0000-0000-0000-000000000001\",\"title\":\"Draft invoice\",\"generation_mode\":\"draft\"}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": {
        "generation_mode": "draft"
    }
}

Curl, Node and response are shown to the right of this endpoint.

Retrieve an invoice

GET /v1/invoices/{id}

One invoice with its client, rows, totals, dates and payment status

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Request body None

None

Response 2

data object

Document list item.

id string

number string

title string

invoice_date string

due_date string

created_at string

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

client_id string

payment_status string

Enum

open partial paid pending failed canceled expired authorized created chargeback refunded

paid_at string Nullable

sent_at string Nullable

project_number string Nullable

is_credit boolean

external_id string Nullable

Your reference, if set.

rows array

name string

quantity number

unit string

unit_price number

vat_rate string

total_excl_vat number

total_incl_vat number

client_company_name string

client_firstname string

client_lastname string

web_url string

pdf_url string

source_id string Nullable

meta object

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Examples

GET /v1/invoices/{id}

curl -X GET "https://api.appficient.nl/v1/invoices/{id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices/{id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices/{id}");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices/{id}", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Update an invoice

PATCH /v1/invoices/{id}

Send at least one field. A final invoice (with a number) only accepts `payment_status`; other fields return `409 invoice_final`

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Request body 4

title string

invoice_date string

due_date string

payment_status string

Enum

open paid pending failed canceled expired authorized created chargeback refunded

{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}

Response 2

data object

Document list item.

id string

number string

title string

invoice_date string

due_date string

created_at string

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

client_id string

payment_status string

Enum

open partial paid pending failed canceled expired authorized created chargeback refunded

paid_at string Nullable

sent_at string Nullable

project_number string Nullable

is_credit boolean

external_id string Nullable

Your reference, if set.

rows array

name string

quantity number

unit string

unit_price number

vat_rate string

total_excl_vat number

total_incl_vat number

client_company_name string

client_firstname string

client_lastname string

web_url string

pdf_url string

source_id string Nullable

meta object

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Examples

PATCH /v1/invoices/{id}

curl -X PATCH "https://api.appficient.nl/v1/invoices/{id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'''

response = requests.request('PATCH', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}';
const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request PATCH 'https://api.appficient.nl/v1/invoices/{id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Patch,
    "https://api.appficient.nl/v1/invoices/{id}");
request.Content = new StringContent(
    "{\"title\":\"string\",\"invoice_date\":\"2026-07-01\",\"due_date\":\"2026-07-01\",\"payment_status\":\"open\"}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"title\":\"string\",\"invoice_date\":\"2026-07-01\",\"due_date\":\"2026-07-01\",\"payment_status\":\"open\"}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}`)
	req, err := http.NewRequest("PATCH", "https://api.appficient.nl/v1/invoices/{id}", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Patch.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Delete an invoice

DELETE /v1/invoices/{id}

Draft only

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Request body None

None

Response 2

data object

Invoice list item.

id string

number string

title string

invoice_date string

due_date string

created_at string

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

client_id string

payment_status string

Payment status string (free text; not a closed enum).

paid_at string Nullable

sent_at string Nullable

project_number string Nullable

is_credit boolean

external_id string Nullable

Your own reference for this document, if set.

rows array

name string

description string

quantity number

unit string

unit_price number

vat_rate string

total_excl_vat number

total_incl_vat number

client_company_name string

client_firstname string

client_lastname string

web_url string

pdf_url string

meta object

{
    "data": {
        "deleted": true,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
    },
    "meta": []
}

Examples

DELETE /v1/invoices/{id}

curl -X DELETE "https://api.appficient.nl/v1/invoices/{id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.delete(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}';
const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request DELETE 'https://api.appficient.nl/v1/invoices/{id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Delete,
    "https://api.appficient.nl/v1/invoices/{id}");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.DELETE().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("DELETE", "https://api.appficient.nl/v1/invoices/{id}", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Delete.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "deleted": true,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Send an invoice

POST /v1/invoices/{id}/send

Sends a finalized invoice by email to `to` and `cc`. The whole body is validated before anything is sent: every address must be valid (`422` `invalid_email`). `send_type` chooses the mail (`invoice`, `credit`, `invoice_rem1`–`invoice_rem3`; default `invoice`); with `reminder` the server chooses the reminder that is due instead. With `include_pdf` (default `true`) a mail without the PDF is never sent (`409` `pdf_missing`). `409` `invoice_draft` (no number yet), `invoice_paid`, `client_reminders_disabled` (reminder types) or `send_failed` (the mail could not be delivered). `422` `send_failed` when the mail was refused for another reason; nothing was sent. For a user the send right for invoices is required (`403` `forbidden`). `403` `EMAIL_NOT_VERIFIED` when the account email address is not confirmed yet during the trial; nothing was sent. `429` `rate_limited` also when the outbound mail limit of the environment is reached; nothing was sent. The AI tool `invoices_send` (MCP) uses stricter rules: see the MCP section of the developer documentation

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Headers 1

Name	Type	Description
`Idempotency-Key`	string	Optional. Replay within 24h returns the same response.

Request body 7

to string Required

Every address must be a valid email address, otherwise `422` (`invalid_email`) and nothing is sent.

subject string Required

message string Required

cc string

Every address must be a valid email address, otherwise `422` (`invalid_email`) and nothing is sent.

send_type string

Email template for send. Allowed per endpoint: invoices `invoice` (default), `credit`, `invoice_rem1`-`3`; quotes `quote` (default), `quote_rem1`-`3`; workorders `workorder`. Another value gives `422` `invalid_value`.

Enum

invoice quote credit invoice_rem1 invoice_rem2 invoice_rem3 quote_rem1 quote_rem2 quote_rem3 workorder

Example: invoice

include_pdf boolean

With `true` the PDF is required; when it cannot be attached the send fails with `409` and nothing is sent.

Example: 1

reminder boolean

Only `true` when a reminder is asked for. The server then sends the reminder that is due for an invoice or quote that was sent before (`invoice_rem1`–`invoice_rem3`, `quote_rem1`). `409` `reminder_unavailable` when the document was never sent or has no reminder (credit invoice, workorder). On REST it cannot be combined with `send_type` (`422`).

{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}

Response 2

data object

success boolean

recipients array

recipients_list string

template boolean

Only via MCP. Always `true`; the official email template of the environment was sent.

send_type string

Only via MCP. The mail that was sent (`invoice`, `credit`, `invoice_rem1`–`invoice_rem3`, `quote`, `quote_rem1`, `workorder`).

subject string

Only via MCP. The subject of the mail that was sent.

meta object

{
    "data": {
        "success": true,
        "recipients": [
            "billing@example.com"
        ],
        "recipients_list": "billing@example.com"
    },
    "meta": []
}

Examples

POST /v1/invoices/{id}/send

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/send" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/send'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/send';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/send';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/send' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/send");
request.Content = new StringContent(
    "{\"to\":\"string\",\"cc\":\"string\",\"subject\":\"string\",\"message\":\"string\",\"send_type\":\"invoice\",\"include_pdf\":true,\"reminder\":false}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/send"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"to\":\"string\",\"cc\":\"string\",\"subject\":\"string\",\"message\":\"string\",\"send_type\":\"invoice\",\"include_pdf\":true,\"reminder\":false}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/send", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/send')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "success": true,
        "recipients": [
            "billing@example.com"
        ],
        "recipients_list": "billing@example.com"
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Credit an invoice

POST /v1/invoices/{id}/credit

Defaults to full credit

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Request body 2

credit_all boolean

Example: 1

row_indexes array

When `credit_all` is false.

{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}

Response 2

data object

Document list item.

id string

number string

title string

invoice_date string

due_date string

created_at string

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

client_id string

payment_status string

Enum

open partial paid pending failed canceled expired authorized created chargeback refunded

paid_at string Nullable

sent_at string Nullable

project_number string Nullable

is_credit boolean

external_id string Nullable

Your reference, if set.

rows array

name string

quantity number

unit string

unit_price number

vat_rate string

total_excl_vat number

total_incl_vat number

client_company_name string

client_firstname string

client_lastname string

web_url string

pdf_url string

source_id string Nullable

meta object

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-999999999999",
        "invoice_date": "2026-01-31",
        "is_credit": true,
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00124",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Examples

POST /v1/invoices/{id}/credit

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/credit" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/credit'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/credit';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "credit_all": true,
    "row_indexes": [
        0
    ]
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/credit';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/credit' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/credit");
request.Content = new StringContent(
    "{\"credit_all\":true,\"row_indexes\":[0]}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/credit"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"credit_all\":true,\"row_indexes\":[0]}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/credit", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/credit')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-999999999999",
        "invoice_date": "2026-01-31",
        "is_credit": true,
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00124",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Download invoice PDF

GET /v1/invoices/{id}/pdf

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Request body None

None

Response 2

data object

id string

pdf_url string

meta object

{
    "data": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "pdf_url": "string"
    },
    "meta": []
}

Examples

GET /v1/invoices/{id}/pdf

curl -X GET "https://api.appficient.nl/v1/invoices/{id}/pdf" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/pdf'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/pdf';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/pdf';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices/{id}/pdf' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices/{id}/pdf");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/pdf"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices/{id}/pdf", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/pdf')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "pdf_url": "string"
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Finalize an invoice

POST /v1/invoices/{id}/finalize

Turns a draft invoice into a final invoice: it gets its definitive invoice number and PDF, exactly like generating it in Appficient. A final invoice can no longer be changed, only credited or sent

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Headers 1

Name	Type	Description
`Idempotency-Key`	string	Optional. Replay within 24h returns the same response.

Request body 1

invoice_date_mode string

`keep` keeps the invoice date of the draft; `today` sets the invoice date to today and recalculates the due date.

Enum

keep today

Example: keep

{
    "invoice_date_mode": "keep"
}

Response 2

data object

Document list item.

id string

number string

title string

invoice_date string

due_date string

created_at string

subtotal number

vat_rate number

vat_amount number

total_excl_vat number

total_incl_vat number

client_id string

payment_status string

Enum

open partial paid pending failed canceled expired authorized created chargeback refunded

paid_at string Nullable

sent_at string Nullable

project_number string Nullable

is_credit boolean

external_id string Nullable

Your reference, if set.

rows array

name string

quantity number

unit string

unit_price number

vat_rate string

total_excl_vat number

total_incl_vat number

client_company_name string

client_firstname string

client_lastname string

web_url string

pdf_url string

source_id string Nullable

meta object

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "is_credit": false,
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00125",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Examples

POST /v1/invoices/{id}/finalize

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/finalize" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_date_mode": "keep"
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/finalize'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "invoice_date_mode": "keep"
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/finalize';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "invoice_date_mode": "keep"
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/finalize';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "invoice_date_mode": "keep"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/finalize' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "invoice_date_mode": "keep"
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/finalize");
request.Content = new StringContent(
    "{\"invoice_date_mode\":\"keep\"}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/finalize"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"invoice_date_mode\":\"keep\"}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "invoice_date_mode": "keep"
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/finalize", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/finalize')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "invoice_date_mode": "keep"
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "is_credit": false,
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00125",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

List payments for an invoice

GET /v1/invoices/{id}/payments

All payments of an invoice (manual and online) with amount, date, status, type and method. Payments registered in Appficient itself can have type `cash`, `bank_transfer` or `credit_card`. A payment with status `paid` counts towards the paid amount of the invoice

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Query 3

Name	Type	Description
`external_id`	string
`status`	string	Payment status.
`type`	string	Only payments of this type.

Request body None

None

Response 2

data array

id string

amount number

date string

status string

Payment status.

Enum

open pending paid failed canceled expired authorized created chargeback refunded

type string

`manual` or `online`.

Enum

manual online

Example: manual

method string

Payment method.

Enum

ideal paypal klarna bancontact in3 creditcard banktransfer

external_id string

provider string

meta object

{
    "data": [
        {
            "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
            "amount": 1210,
            "date": "2026-02-10",
            "status": "paid",
            "type": "manual",
            "method": "banktransfer",
            "external_id": "",
            "provider": ""
        }
    ],
    "meta": []
}

Examples

GET /v1/invoices/{id}/payments

curl -X GET "https://api.appficient.nl/v1/invoices/{id}/payments" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices/{id}/payments' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices/{id}/payments");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices/{id}/payments", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": [
        {
            "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
            "amount": 1210,
            "date": "2026-02-10",
            "status": "paid",
            "type": "manual",
            "method": "banktransfer",
            "external_id": "",
            "provider": ""
        }
    ],
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Create a payment

POST /v1/invoices/{id}/payments

Registers a payment on an invoice. `type` defaults to `manual`: the payment is recorded as paid, the same as registering a payment in Appficient (an activity on the invoice; the invoice becomes paid once its payments cover the total). `amount` defaults to the open amount and may not exceed it (`422`, detail `exceeds_open_amount` with the open amount). For `manual` only: the invoice must be final, so a draft gives `422` (detail `invoice_draft`); a quote, workorder or credit note gives `422` (detail `payment_not_allowed`); an invoice that is already paid gives `409 invoice_paid`; while another request registers a manual payment on the same invoice, the call waits briefly and then gives `409 busy` (try again in a moment); a negative `refunded` amount gives `422` (detail `refund_not_supported_manual`, register refunds as `online` with `external_id`). A repeated `external_id` gives `409 duplicate_external_id`. List the payments first (`GET /v1/invoices/ /payments`) so the same payment is not registered twice. On `server_error` the result is unknown: do not retry, list the payments first. The AI tool `invoice_payments_create` (MCP) only registers manual payments: see the MCP section of the developer documentation

Authorization: HTTP

type: http

scheme: bearer

Path 1

Name	Type	Description
`id` Required	string

Headers 1

Name	Type	Description
`Idempotency-Key`	string	Optional. Replay within 24h returns the same response.

Request body 10

type string

`manual` or `online`.

Enum

manual online

Example: manual

amount number

Amount incl. VAT. Defaults to the open amount of the invoice and may not exceed it.

date string

Payment date (YYYY-MM-DD). Defaults to today.

description string

Optional note on the payment.

external_id string

provider string

status string

Payment status.

Enum

open pending paid failed canceled expired authorized created chargeback refunded

method string

Payment method.

Enum

ideal paypal klarna bancontact in3 creditcard banktransfer

payment_data object

feedback_data object

{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}

Response 2

data object

invoice object

id string

paid_amount number

price number

payment object

id string

amount number

date string

status string

Payment status.

Enum

open pending paid failed canceled expired authorized created chargeback refunded

type string

`manual` or `online`.

Enum

manual online

Example: manual

method string

Payment method.

Enum

ideal paypal klarna bancontact in3 creditcard banktransfer

external_id string

provider string

meta object

{
    "data": {
        "invoice": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "paid_amount": 1210,
            "price": 1210
        },
        "payment": {
            "type": "manual",
            "amount": 1210,
            "date": "2026-02-10",
            "status": "paid",
            "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
            "method": "banktransfer"
        }
    },
    "meta": []
}

Examples

POST /v1/invoices/{id}/payments

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/payments" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/payments' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/payments");
request.Content = new StringContent(
    "{\"type\":\"manual\",\"amount\":0,\"date\":\"2026-07-01\",\"description\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"status\":\"open\",\"method\":\"ideal\",\"payment_data\":[],\"feedback_data\":[]}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"type\":\"manual\",\"amount\":0,\"date\":\"2026-07-01\",\"description\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"status\":\"open\",\"method\":\"ideal\",\"payment_data\":[],\"feedback_data\":[]}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/payments", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "invoice": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "paid_amount": 1210,
            "price": 1210
        },
        "payment": {
            "type": "manual",
            "amount": 1210,
            "date": "2026-02-10",
            "status": "paid",
            "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
            "method": "banktransfer"
        }
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Update a payment

PATCH /v1/invoices/{id}/payments/{payment_id}

Send at least one field. The payment must belong to this invoice, otherwise `404` (`payment_not_found`)

Authorization: HTTP

type: http

scheme: bearer

Path 2

Name	Type	Description
`id` Required	string
`payment_id` Required	string

Request body 7

amount number

date string

status string

method string

external_id string

provider string

payment_data object

{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}

Response 2

data object

invoice object

id string

paid_amount number

price number

payment object

id string

amount number

date string

status string

Payment status.

Enum

open pending paid failed canceled expired authorized created chargeback refunded

type string

`manual` or `online`.

Enum

manual online

Example: manual

method string

Payment method.

Enum

ideal paypal klarna bancontact in3 creditcard banktransfer

external_id string

provider string

meta object

{
    "data": {
        "amount": 1210,
        "created_at": "2026-02-10T16:00:00+01:00",
        "description": "Bankoverschrijving",
        "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "payment_date": "2026-02-10",
        "type": "bank"
    },
    "meta": []
}

Examples

PATCH /v1/invoices/{id}/payments/{payment_id}

curl -X PATCH "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'''

response = requests.request('PATCH', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request PATCH 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Patch,
    "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}");
request.Content = new StringContent(
    "{\"amount\":0,\"date\":\"2026-07-01\",\"status\":\"string\",\"method\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"payment_data\":[]}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"amount\":0,\"date\":\"2026-07-01\",\"status\":\"string\",\"method\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"payment_data\":[]}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}`)
	req, err := http.NewRequest("PATCH", "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Patch.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "amount": 1210,
        "created_at": "2026-02-10T16:00:00+01:00",
        "description": "Bankoverschrijving",
        "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "payment_date": "2026-02-10",
        "type": "bank"
    },
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

Delete a payment

DELETE /v1/invoices/{id}/payments/{payment_id}

The payment must belong to this invoice, otherwise `404` (`payment_not_found`) and nothing is deleted. The paid status of the invoice is recalculated

Authorization: HTTP

type: http

scheme: bearer

Path 2

Name	Type	Description
`id` Required	string
`payment_id` Required	string

Request body None

None

Response None

None

Examples

DELETE /v1/invoices/{id}/payments/{payment_id}

curl -X DELETE "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.delete(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request DELETE 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Delete,
    "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.DELETE().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("DELETE", "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Delete.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

Curl, Node and response are shown to the right of this endpoint.

List payment terms

GET /v1/payment-terms

The default payment terms of the environment in days: `default` for documents and `default_client` for clients

Authorization: HTTP

type: http

scheme: bearer

Request body None

None

Response 2

data array

code string

days integer

label string

meta object

{
    "data": [
        {
            "days": 14,
            "name": "14 dagen"
        }
    ],
    "meta": []
}

Examples

GET /v1/payment-terms

curl -X GET "https://api.appficient.nl/v1/payment-terms" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/payment-terms'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/payment-terms';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/payment-terms';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/payment-terms' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/payment-terms");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/payment-terms"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/payment-terms", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/payment-terms')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": [
        {
            "days": 14,
            "name": "14 dagen"
        }
    ],
    "meta": []
}

Curl, Node and response are shown to the right of this endpoint.

GET /v1/invoices

curl -X GET "https://api.appficient.nl/v1/invoices" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": [
        {
            "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "created_at": "2026-01-31T09:00:00+01:00",
            "due_date": "2026-02-14",
            "external_id": null,
            "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "invoice_date": "2026-01-31",
            "number": "2026-00123",
            "payment_status": "open",
            "subtotal": 1000,
            "title": "Werkzaamheden januari",
            "total_excl_vat": 1000,
            "total_incl_vat": 1210,
            "vat_amount": 210,
            "vat_rate": 21
        }
    ],
    "meta": {
        "page": 1,
        "pages": 1,
        "per_page": 25,
        "total": 1
    }
}

POST /v1/invoices

curl -X POST "https://api.appficient.nl/v1/invoices" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'

import requests

url = 'https://api.appficient.nl/v1/invoices'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices");
request.Content = new StringContent(
    "{\"client_id\":\"00000000-0000-0000-0000-000000000001\",\"title\":\"Draft invoice\",\"generation_mode\":\"draft\"}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"client_id\":\"00000000-0000-0000-0000-000000000001\",\"title\":\"Draft invoice\",\"generation_mode\":\"draft\"}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "client_id": "00000000-0000-0000-0000-000000000001",
    "title": "Draft invoice",
    "generation_mode": "draft"
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": {
        "generation_mode": "draft"
    }
}

GET /v1/invoices/{id}

curl -X GET "https://api.appficient.nl/v1/invoices/{id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices/{id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices/{id}");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices/{id}", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

PATCH /v1/invoices/{id}

curl -X PATCH "https://api.appficient.nl/v1/invoices/{id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'''

response = requests.request('PATCH', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}';
const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request PATCH 'https://api.appficient.nl/v1/invoices/{id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Patch,
    "https://api.appficient.nl/v1/invoices/{id}");
request.Content = new StringContent(
    "{\"title\":\"string\",\"invoice_date\":\"2026-07-01\",\"due_date\":\"2026-07-01\",\"payment_status\":\"open\"}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"title\":\"string\",\"invoice_date\":\"2026-07-01\",\"due_date\":\"2026-07-01\",\"payment_status\":\"open\"}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}`)
	req, err := http.NewRequest("PATCH", "https://api.appficient.nl/v1/invoices/{id}", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Patch.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "title": "string",
    "invoice_date": "2026-07-01",
    "due_date": "2026-07-01",
    "payment_status": "open"
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00123",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

DELETE /v1/invoices/{id}

curl -X DELETE "https://api.appficient.nl/v1/invoices/{id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.delete(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}';
const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request DELETE 'https://api.appficient.nl/v1/invoices/{id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Delete,
    "https://api.appficient.nl/v1/invoices/{id}");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.DELETE().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("DELETE", "https://api.appficient.nl/v1/invoices/{id}", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Delete.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "deleted": true,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
    },
    "meta": []
}

POST /v1/invoices/{id}/send

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/send" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/send'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/send';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/send';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/send' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/send");
request.Content = new StringContent(
    "{\"to\":\"string\",\"cc\":\"string\",\"subject\":\"string\",\"message\":\"string\",\"send_type\":\"invoice\",\"include_pdf\":true,\"reminder\":false}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/send"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"to\":\"string\",\"cc\":\"string\",\"subject\":\"string\",\"message\":\"string\",\"send_type\":\"invoice\",\"include_pdf\":true,\"reminder\":false}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/send", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/send')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "to": "string",
    "cc": "string",
    "subject": "string",
    "message": "string",
    "send_type": "invoice",
    "include_pdf": true,
    "reminder": false
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "success": true,
        "recipients": [
            "billing@example.com"
        ],
        "recipients_list": "billing@example.com"
    },
    "meta": []
}

POST /v1/invoices/{id}/credit

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/credit" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/credit'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/credit';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "credit_all": true,
    "row_indexes": [
        0
    ]
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/credit';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/credit' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/credit");
request.Content = new StringContent(
    "{\"credit_all\":true,\"row_indexes\":[0]}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/credit"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"credit_all\":true,\"row_indexes\":[0]}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/credit", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/credit')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "credit_all": true,
    "row_indexes": [
        0
    ]
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-999999999999",
        "invoice_date": "2026-01-31",
        "is_credit": true,
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00124",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

GET /v1/invoices/{id}/pdf

curl -X GET "https://api.appficient.nl/v1/invoices/{id}/pdf" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/pdf'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/pdf';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/pdf';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices/{id}/pdf' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices/{id}/pdf");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/pdf"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices/{id}/pdf", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/pdf')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "pdf_url": "string"
    },
    "meta": []
}

POST /v1/invoices/{id}/finalize

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/finalize" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_date_mode": "keep"
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/finalize'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "invoice_date_mode": "keep"
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/finalize';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "invoice_date_mode": "keep"
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/finalize';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "invoice_date_mode": "keep"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/finalize' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "invoice_date_mode": "keep"
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/finalize");
request.Content = new StringContent(
    "{\"invoice_date_mode\":\"keep\"}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/finalize"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"invoice_date_mode\":\"keep\"}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "invoice_date_mode": "keep"
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/finalize", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/finalize')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "invoice_date_mode": "keep"
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "client": {
            "email": "info@voorbeeld.nl",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Voorbeeld BV"
        },
        "client_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-31T09:00:00+01:00",
        "due_date": "2026-02-14",
        "external_id": null,
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "invoice_date": "2026-01-31",
        "is_credit": false,
        "lines": [
            {
                "quantity": 10,
                "title": "Consultancy",
                "total_excl_vat": 1000,
                "total_incl_vat": 1210,
                "unit_price": 100,
                "vat_code": "high",
                "vat_rate": 21
            }
        ],
        "number": "2026-00125",
        "payment_status": "open",
        "subtotal": 1000,
        "title": "Werkzaamheden januari",
        "total_excl_vat": 1000,
        "total_incl_vat": 1210,
        "vat_amount": 210,
        "vat_rate": 21
    },
    "meta": []
}

GET /v1/invoices/{id}/payments

curl -X GET "https://api.appficient.nl/v1/invoices/{id}/payments" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/invoices/{id}/payments' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/invoices/{id}/payments");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/invoices/{id}/payments", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": [
        {
            "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
            "amount": 1210,
            "date": "2026-02-10",
            "status": "paid",
            "type": "manual",
            "method": "banktransfer",
            "external_id": "",
            "provider": ""
        }
    ],
    "meta": []
}

POST /v1/invoices/{id}/payments

curl -X POST "https://api.appficient.nl/v1/invoices/{id}/payments" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'''

response = requests.request('POST', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request POST 'https://api.appficient.nl/v1/invoices/{id}/payments' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.appficient.nl/v1/invoices/{id}/payments");
request.Content = new StringContent(
    "{\"type\":\"manual\",\"amount\":0,\"date\":\"2026-07-01\",\"description\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"status\":\"open\",\"method\":\"ideal\",\"payment_data\":[],\"feedback_data\":[]}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"type\":\"manual\",\"amount\":0,\"date\":\"2026-07-01\",\"description\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"status\":\"open\",\"method\":\"ideal\",\"payment_data\":[],\"feedback_data\":[]}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}`)
	req, err := http.NewRequest("POST", "https://api.appficient.nl/v1/invoices/{id}/payments", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "type": "manual",
    "amount": 0,
    "date": "2026-07-01",
    "description": "string",
    "external_id": "string",
    "provider": "string",
    "status": "open",
    "method": "ideal",
    "payment_data": [],
    "feedback_data": []
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "invoice": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "paid_amount": 1210,
            "price": 1210
        },
        "payment": {
            "type": "manual",
            "amount": 1210,
            "date": "2026-02-10",
            "status": "paid",
            "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
            "method": "banktransfer"
        }
    },
    "meta": []
}

PATCH /v1/invoices/{id}/payments/{payment_id}

curl -X PATCH "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}
payload = '''{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'''

response = requests.request('PATCH', url, headers=headers, data=payload)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}),
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request PATCH 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --body '{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Patch,
    "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}");
request.Content = new StringContent(
    "{\"amount\":0,\"date\":\"2026-07-01\",\"status\":\"string\",\"method\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"payment_data\":[]}",
    Encoding.UTF8,
    "application/json");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx")
    .header("Content-Type", "application/json");

HttpRequest request = builder
    .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"amount\":0,\"date\":\"2026-07-01\",\"status\":\"string\",\"method\":\"string\",\"external_id\":\"string\",\"provider\":\"string\",\"payment_data\":[]}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}`)
	req, err := http.NewRequest("PATCH", "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Patch.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'
req['Content-Type'] = 'application/json'
req.body = '{
    "amount": 0,
    "date": "2026-07-01",
    "status": "string",
    "method": "string",
    "external_id": "string",
    "provider": "string",
    "payment_data": []
}'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": {
        "amount": 1210,
        "created_at": "2026-02-10T16:00:00+01:00",
        "description": "Bankoverschrijving",
        "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "payment_date": "2026-02-10",
        "type": "bank"
    },
    "meta": []
}

DELETE /v1/invoices/{id}/payments/{payment_id}

curl -X DELETE "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.delete(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request DELETE 'https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Delete,
    "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.DELETE().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("DELETE", "https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/invoices/{id}/payments/{payment_id}')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Delete.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

GET /v1/payment-terms

curl -X GET "https://api.appficient.nl/v1/payment-terms" \
  -H "Authorization: Bearer apf_xxxxxxxx" \
  -H "Accept: application/json"

import requests

url = 'https://api.appficient.nl/v1/payment-terms'
headers = {
    'Authorization': 'Bearer apf_xxxxxxxx',
    'Accept': 'application/json',
}

response = requests.get(url, headers=headers)
data = response.json()

const url = 'https://api.appficient.nl/v1/payment-terms';
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Bearer apf_xxxxxxxx',
    Accept: 'application/json',
  },
};

const res = await fetch(url, options);
const json = await res.json();

<?php
$url = 'https://api.appficient.nl/v1/payment-terms';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer apf_xxxxxxxx',
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode($response, true);

postman request GET 'https://api.appficient.nl/v1/payment-terms' \
  --header 'Authorization: Bearer apf_xxxxxxxx' \
  --header 'Accept: application/json'

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "apf_xxxxxxxx");
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));

using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.appficient.nl/v1/payment-terms");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://api.appficient.nl/v1/payment-terms"))
    .header("Accept", "application/json")
    .header("Authorization", "Bearer apf_xxxxxxxx");

HttpRequest request = builder.GET().build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
String json = response.body();

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.appficient.nl/v1/payment-terms", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer apf_xxxxxxxx")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.appficient.nl/v1/payment-terms')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Get.new(uri)
req['Accept'] = 'application/json'
req['Authorization'] = 'Bearer apf_xxxxxxxx'

res = http.request(req)
data = JSON.parse(res.body)

{
    "data": [
        {
            "days": 14,
            "name": "14 dagen"
        }
    ],
    "meta": []
}