List price list items

GET

price-list-items

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/price-list-items \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/price-list-items"

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/price-list-items', 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/price-list-items",
  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/price-list-items"

	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/price-list-items")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/price-list-items")

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": 701,
      "name": "Service package",
      "description": "Monthly service and support",
      "unitId": 1,
      "unit": {
        "id": 1,
        "name": "pcs"
      },
      "unitPrice": 129.9,
      "vatRate": 20,
      "unitPriceWithVat": 155.88,
      "stock": 12,
      "stocks": [
        {
          "warehouseId": 15,
          "warehouseName": "Main warehouse",
          "warehouseCode": "MAIN-WH",
          "stockQuantity": 7
        }
      ],
      "ean": "8586012345678",
      "useWarehouse": true,
      "warehouseCode": "SKU-PUBLIC-001",
      "enableNegativeStock": false,
      "maxStock": 250,
      "purchasePrice": 89.5,
      "purchaseVatRate": 20,
      "purchasePriceWithVat": 107.4
    }
  ],
  "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": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Authorizations

Authorization

string

header

required

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

Query Parameters

name

string

Full-text search by item name, warehouse code, or EAN.

Maximum string length: 255

Example:

"match"

priceFrom

number<float>

Minimum unit price excluding VAT.

Example:

10

priceTo

number<float>

Maximum unit price excluding VAT.

Example:

100

stockFrom

number<float>

Minimum current stock level of the item.

Example:

1

stockTo

number<float>

Maximum current stock level of the item.

Example:

50

onlyWarehouseItems

boolean

default:false

When true, the endpoint returns only items with warehouse tracking enabled.

Example:

true

sortBy

enum<string>

default:name

Field used to sort the list.

Available options:

name,

unit_price,

stock

Example:

"stock"

sortDirection

enum<string>

default:asc

Sort direction.

Available options:

asc,

desc

Example:

"desc"

perPage

integer

default:50

Number of items per page. Maximum is 200.

Required range: 1 <= x <= 200

Example:

50

page

integer

default:1

Page number to return.

Required range: x >= 1

Example:

2

Response

Price list item list.

data

object[]

Items on the current page.

Show child attributes

paginator

object

Pagination metadata for the current result.

Show child attributes

Create price list itemCreates a new price list or warehouse item. If you send an `Idempotency-Key`, repeating the create request with the same key and the same payload returns the original response without creating a second item.

List price list items

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/price-list-items \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/price-list-items"

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/price-list-items', 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/price-list-items",
  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/price-list-items"

	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/price-list-items")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/price-list-items")

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": 701,
      "name": "Service package",
      "description": "Monthly service and support",
      "unitId": 1,
      "unit": {
        "id": 1,
        "name": "pcs"
      },
      "unitPrice": 129.9,
      "vatRate": 20,
      "unitPriceWithVat": 155.88,
      "stock": 12,
      "stocks": [
        {
          "warehouseId": 15,
          "warehouseName": "Main warehouse",
          "warehouseCode": "MAIN-WH",
          "stockQuantity": 7
        }
      ],
      "ean": "8586012345678",
      "useWarehouse": true,
      "warehouseCode": "SKU-PUBLIC-001",
      "enableNegativeStock": false,
      "maxStock": 250,
      "purchasePrice": 89.5,
      "purchaseVatRate": 20,
      "purchasePriceWithVat": 107.4
    }
  ],
  "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": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

List price list items

Authorizations

Query Parameters

Response