Show business case

GET

business-cases

{businessCase}

Show business case

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/business-cases/{businessCase} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/business-cases/{businessCase}"

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/{businessCase}', 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/{businessCase}",
  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/{businessCase}"

	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/{businessCase}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/business-cases/{businessCase}")

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

{
  "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"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Authorizations

Authorization

string

header

required

Bearer token created for a specific company in Integrations → API.

Path Parameters

businessCase

integer

required

Business case ID.

Example:

501

Response

Business-case detail.

Business case, including the nested client or supplier and an optional status.

integer

Internal business-case ID in Fintoro.

Example:

501

contactType

enum<string>

Type of linked contact. client means a client, supplier means a supplier.

Available options:

client,

supplier

Example:

"client"

contactId

integer

Internal ID of the linked contact matching contactType.

Example:

101

client

object | null

Nested client object when the business case is linked to a client.

Show child attributes

supplier

object | null

Nested supplier object when the business case is linked to a supplier.

Show child attributes

name

string

Business-case name.

Example:

"Client pipeline"

description

string | null

Optional business-case description.

Example:

"Opportunity description"

status

object | null

Current business-case status as a nested object. May be null when the case is not assigned to any status.

Show child attributes

boardPosition

integer

Internal position of the business case within its current status or in the no-status column.

Example:

2

createdAt

string<date-time> | null

Business-case creation timestamp.

Example:

"2026-03-10T10:00:00+01:00"

updatedAt

string<date-time> | null

Business-case last update timestamp.

Example:

"2026-03-10T10:30:00+01:00"

Update business casePartially updates a business case. You can change `name`, `description`, and `statusId`, and `statusId` may also be `null`. This endpoint does not change the linked client or supplier; sending `clientId` or `supplierId` during update returns a validation error.

Show business case

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/business-cases/{businessCase} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/business-cases/{businessCase}"

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/{businessCase}', 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/{businessCase}",
  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/{businessCase}"

	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/{businessCase}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/business-cases/{businessCase}")

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

{
  "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"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

Authorizations

Path Parameters

Response