curl --request GET \
--url https://api.fidly.be/relations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fidly.be/relations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fidly.be/relations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fidly.be/relations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fidly.be/relations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fidly.be/relations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fidly.be/relations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "<string>",
"type": "company",
"name": "<string>",
"email": "<string>",
"phone": "<string>",
"language": "<string>",
"address": {
"street": "<string>",
"street_number": "<string>",
"street2": "<string>",
"postal_code": "<string>",
"city": "<string>",
"province": "<string>",
"country_code": "<string>"
},
"vat": "<string>",
"identifier": "<string>",
"electronic_address": "<string>",
"is_customer": true,
"is_supplier": true
}
],
"total": 123,
"limit": 123,
"offset": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}List Relations
curl --request GET \
--url https://api.fidly.be/relations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fidly.be/relations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fidly.be/relations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fidly.be/relations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fidly.be/relations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fidly.be/relations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fidly.be/relations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "<string>",
"type": "company",
"name": "<string>",
"email": "<string>",
"phone": "<string>",
"language": "<string>",
"address": {
"street": "<string>",
"street_number": "<string>",
"street2": "<string>",
"postal_code": "<string>",
"city": "<string>",
"province": "<string>",
"country_code": "<string>"
},
"vat": "<string>",
"identifier": "<string>",
"electronic_address": "<string>",
"is_customer": true,
"is_supplier": true
}
],
"total": 123,
"limit": 123,
"offset": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Max items returned (1–100).
1 <= x <= 100Number of items to skip (pagination). Capped at 10000.
0 <= x <= 10000Filter by relation type: company or contact.
Filter companies that are (not) customers. Excludes contacts.
Filter companies that are (not) suppliers. Excludes contacts.
Exact VAT number match (companies only).
Exact legal identifier match (companies only).
Response
Successful Response
A page of relations, mixing both types.
Named subclass of Page only so the schema is called RelationPage in the docs: a
generic parametrised with an annotated union gets an unreadable generated name.
A business third party. Carries the fields an individual has no equivalent of
(vat, identifier, electronic_address, is_customer, is_supplier), and none of
the contact-only ones — first_name/last_name are simply absent from the response.
- CompanyRelationOut
- ContactRelationOut
Show child attributes
Show child attributes