Business Cases
List business cases
Returns business cases. The endpoint supports filtering by client, supplier, status, and full-text search in the business-case name or description. The response always returns the nested client or supplier based on the stored record, an optional nested status, and paginator metadata.
GET
/
business-cases
List business cases
curl --request GET \
--url https://app.fintoro.sk/api/public/v1/business-cases \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.fintoro.sk/api/public/v1/business-cases"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.fintoro.sk/api/public/v1/business-cases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/business-cases",
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://app.fintoro.sk/api/public/v1/business-cases"
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://app.fintoro.sk/api/public/v1/business-cases")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.fintoro.sk/api/public/v1/business-cases")
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{
"data": [
{
"id": 501,
"contactType": "client",
"contactId": 101,
"client": {
"id": 101,
"name": "Acme s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": true,
"email": "billing@acme.test",
"street": "Main Street 1",
"city": "Bratislava",
"zip": "81101",
"country": {
"id": 703,
"name": "Slovakia",
"code": "SK",
"eu": true
},
"hasDeliveryAddress": true,
"deliveryStreet": "Warehouse Street 9",
"deliveryCity": "Kosice",
"deliveryZip": "04001",
"deliveryCountry": {
"id": 703,
"name": "Slovakia",
"code": "SK",
"eu": true
},
"createdAt": "2026-03-03T12:00:00+01:00",
"updatedAt": "2026-03-03T15:45:00+01:00",
"preferredDeliveryMethodId": 1,
"preferredPaymentMethodId": 1,
"preferredCurrencyId": 1,
"preferredLanguageId": 1,
"preferredDueDays": 14,
"preferredNote": "Due within 14 days.",
"preferredVariableSymbol": 2026001,
"preferredConstantSymbol": 308,
"preferredSpecificSymbol": 55,
"preferredTextAboveItems": "Thank you for your cooperation."
},
"supplier": {
"id": 151,
"type": "company",
"name": "Supplier s.r.o.",
"subjectId": "12345678",
"taxId": "2020202020",
"vatId": "SK2020202020",
"isVatPayer": true,
"email": "billing@supplier.test",
"street": "Supplier Street 1",
"city": "Bratislava",
"zip": "81101",
"country": {
"id": 703,
"name": "Slovakia",
"code": "SK",
"eu": true
}
},
"name": "Client pipeline",
"description": "Opportunity description",
"status": {
"id": 41,
"name": "Negotiation",
"color": "#22aa44"
},
"boardPosition": 2,
"createdAt": "2026-03-10T10:00:00+01:00",
"updatedAt": "2026-03-10T10:30:00+01:00"
}
],
"paginator": {
"currentPage": 2,
"perPage": 10,
"totalPages": 5,
"totalResults": 42,
"currentFrom": 11,
"currentTo": 20,
"firstPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
"lastPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=5",
"nextPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=3",
"previousPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
"links": [
{
"url": "https://app.fintoro.sk/api/public/v1/invoices?page=2",
"label": "2",
"active": false
}
]
}
}{
"message": "This action is unauthorized."
}{
"message": "The given data was invalid.",
"errors": {}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}{
"message": "Service Unavailable"
}Authorizations
Bearer token created for a specific company in Integrations → API.
Query Parameters
Filter by a client. This field is mutually exclusive with supplierId.
Example:
101
Filter by a supplier. This field is mutually exclusive with clientId.
Example:
151
Filter by a business-case status.
Example:
41
Full-text search by business-case name or description.
Maximum string length:
255Example:
"keyword"
Field used to sort business cases.
Available options:
name, createdAt, updatedAt, boardPosition Example:
"updatedAt"
Sort direction.
Available options:
asc, desc Example:
"desc"
Number of results per page. Maximum is 200.
Required range:
1 <= x <= 200Example:
10
Page number to return.
Required range:
x >= 1Example:
1
⌘I
List business cases
curl --request GET \
--url https://app.fintoro.sk/api/public/v1/business-cases \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.fintoro.sk/api/public/v1/business-cases"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.fintoro.sk/api/public/v1/business-cases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/business-cases",
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://app.fintoro.sk/api/public/v1/business-cases"
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://app.fintoro.sk/api/public/v1/business-cases")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.fintoro.sk/api/public/v1/business-cases")
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{
"data": [
{
"id": 501,
"contactType": "client",
"contactId": 101,
"client": {
"id": 101,
"name": "Acme s.r.o.",
"type": "company",
"subjectId": "12345678",
"taxId": "2020123456",
"vatId": "SK2020123456",
"isVatPayer": true,
"email": "billing@acme.test",
"street": "Main Street 1",
"city": "Bratislava",
"zip": "81101",
"country": {
"id": 703,
"name": "Slovakia",
"code": "SK",
"eu": true
},
"hasDeliveryAddress": true,
"deliveryStreet": "Warehouse Street 9",
"deliveryCity": "Kosice",
"deliveryZip": "04001",
"deliveryCountry": {
"id": 703,
"name": "Slovakia",
"code": "SK",
"eu": true
},
"createdAt": "2026-03-03T12:00:00+01:00",
"updatedAt": "2026-03-03T15:45:00+01:00",
"preferredDeliveryMethodId": 1,
"preferredPaymentMethodId": 1,
"preferredCurrencyId": 1,
"preferredLanguageId": 1,
"preferredDueDays": 14,
"preferredNote": "Due within 14 days.",
"preferredVariableSymbol": 2026001,
"preferredConstantSymbol": 308,
"preferredSpecificSymbol": 55,
"preferredTextAboveItems": "Thank you for your cooperation."
},
"supplier": {
"id": 151,
"type": "company",
"name": "Supplier s.r.o.",
"subjectId": "12345678",
"taxId": "2020202020",
"vatId": "SK2020202020",
"isVatPayer": true,
"email": "billing@supplier.test",
"street": "Supplier Street 1",
"city": "Bratislava",
"zip": "81101",
"country": {
"id": 703,
"name": "Slovakia",
"code": "SK",
"eu": true
}
},
"name": "Client pipeline",
"description": "Opportunity description",
"status": {
"id": 41,
"name": "Negotiation",
"color": "#22aa44"
},
"boardPosition": 2,
"createdAt": "2026-03-10T10:00:00+01:00",
"updatedAt": "2026-03-10T10:30:00+01:00"
}
],
"paginator": {
"currentPage": 2,
"perPage": 10,
"totalPages": 5,
"totalResults": 42,
"currentFrom": 11,
"currentTo": 20,
"firstPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
"lastPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=5",
"nextPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=3",
"previousPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
"links": [
{
"url": "https://app.fintoro.sk/api/public/v1/invoices?page=2",
"label": "2",
"active": false
}
]
}
}{
"message": "This action is unauthorized."
}{
"message": "The given data was invalid.",
"errors": {}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}{
"message": "Service Unavailable"
}
