Abonnementen ophalen
GET
/v1/subscriptions
invoices.read
Type vast subscription. Zelfde queryfilters als facturen
Authorization: HTTP
name: httpBearer
type: http
scheme: bearer
Query
| Naam | Type | Beschrijving |
|---|---|---|
page
|
integer | Paginanummer (vanaf 1, default 1) |
per_page
|
integer | Items per pagina (default 25, max 200) |
id
|
string | |
client_id
|
string | |
legacy_status_id
|
integer | Legacy integer filter; removed in v2. |
number
|
string | Filter op documentnummer |
date_from
|
string | Factuurdatum vanaf (Y-m-d) |
date_to
|
string | Factuurdatum tot (Y-m-d) |
due_date_from
|
string | Vervaldatum vanaf (Y-m-d) |
due_date_to
|
string | Vervaldatum tot (Y-m-d) |
created_from
|
string | Aangemaakt vanaf |
created_to
|
string | Aangemaakt tot |
search
|
string | Vrije tekstzoekopdracht |
payment_status
|
string | Filter op payment_status |
sort
|
string | Sortering: invoice_date, due_date, created_at, number, id |
order
|
string | asc of desc (default desc) |
Request body
Geen
Response
data
object[]
guid
string
Example:
a1b2c3d4-e5f6-7890-abcd-ef1234567890
number
string
Example:
F.2026.522
title
string
Example:
Onderhoud juli
type
string
Enum
invoice
quote
subscription
Example:
subscription
invoice_date
string
Example:
2026-07-01
due_date
string
Example:
2026-07-15
created_at
string
Example:
2026-07-01T10:00:00+02:00
subtotal
number
Example:
100
vat
number
Example:
21
vat_price
number
Example:
21
total_ex_vat
number
Example:
100
total_inc_vat
number
Example:
121
client_guid
string
Example:
b2c3d4e5-f6a7-8901-bcde-f12345678901
payment_status
string
Example:
open
credit
boolean
Example:
false
meta
object
page
integer
Example:
1
per_page
integer
Example:
25
total
integer
Example:
1
pages
integer
Example:
1
{
"data": [
{
"guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"number": "F.2026.522",
"title": "Onderhoud juli",
"type": "subscription",
"invoice_date": "2026-07-01",
"due_date": "2026-07-15",
"created_at": "2026-07-01T10:00:00+02:00",
"subtotal": 100.00,
"vat": 21.00,
"vat_price": 21.00,
"total_ex_vat": 100.00,
"total_inc_vat": 121.00,
"client_guid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"payment_status": "open",
"credit": false
}
],
"meta": {
"page": 1,
"per_page": 25,
"total": 1,
"pages": 1
}
}Examples
GET /v1/subscriptions
curl -X GET "https://api.appficient.nl/v1/subscriptions" \
-H "Authorization: Bearer apf_xxxxxxxx" \
-H "Accept: application/json"import requests
url = 'https://api.appficient.nl/v1/subscriptions'
headers = {
'Authorization': 'Bearer apf_xxxxxxxx',
'Accept': 'application/json',
}
response = requests.get(url, headers=headers)
data = response.json()
const url = 'https://api.appficient.nl/v1/subscriptions';
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/subscriptions';
$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/subscriptions' \
--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/subscriptions");
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/subscriptions"))
.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/subscriptions", 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/subscriptions')
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": [
{
"guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"number": "F.2026.522",
"title": "Onderhoud juli",
"type": "subscription",
"invoice_date": "2026-07-01",
"due_date": "2026-07-15",
"created_at": "2026-07-01T10:00:00+02:00",
"subtotal": 100.00,
"vat": 21.00,
"vat_price": 21.00,
"total_ex_vat": 100.00,
"total_inc_vat": 121.00,
"client_guid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"payment_status": "open",
"credit": false
}
],
"meta": {
"page": 1,
"per_page": 25,
"total": 1,
"pages": 1
}
}Curl, Node en response staan rechts naast dit endpoint.