Skip to main content
GET
/
proformas
/
{proforma}
Show proforma
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/proformas/{proforma} \
  --header 'Authorization: Bearer <token>'
{
  "id": 401,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "proforma",
  "number": "20260001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/proforma/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/proformas/401/pdf",
  "company": {
    "name": "Fintoro s.r.o.",
    "subjectId": "12345678",
    "legalForm": "Limited liability company",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "vatPayerTypeId": 4,
    "country": "Slovakia",
    "city": "Bratislava",
    "street": "Main Street 1",
    "zip": "81101",
    "logo": "https://cdn.fintoro.sk/company/logo.svg",
    "signature": "https://cdn.fintoro.sk/company/signature.png",
    "registrationCourt": "City Court Bratislava III",
    "registrationNumber": "12345/B",
    "email": "support@fintoro.sk",
    "phone": "+421900000000",
    "web": "https://fintoro.sk"
  },
  "clientId": 101,
  "client": {
    "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",
    "countryId": 703,
    "country": {
      "id": 703,
      "name": "Slovakia",
      "code": "SK",
      "eu": true
    },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Warehouse 9",
    "deliveryCity": "Kosice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": {
      "id": 703,
      "name": "Slovakia",
      "code": "SK",
      "eu": true
    }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": {
      "id": 23,
      "name": "Tatra Banka",
      "swift": "TATRSKBX"
    },
    "name": "Main account",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "payments": [
    {
      "id": 801,
      "documentType": "invoice",
      "documentId": 301,
      "paymentMethod": {
        "id": 1,
        "name": "Bank transfer"
      },
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "paymentDate": "2026-03-07",
      "amount": 15.5,
      "currencyRate": 1,
      "receiptInvoice": {
        "id": 301,
        "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
        "type": "invoice",
        "number": "20260001",
        "clientId": 101,
        "client": {
          "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",
          "countryId": 703,
          "country": {
            "id": 703,
            "name": "Slovakia",
            "code": "SK",
            "eu": true
          },
          "hasDeliveryAddress": true,
          "deliveryStreet": "Warehouse 9",
          "deliveryCity": "Kosice",
          "deliveryZip": "04001",
          "deliveryCountryId": 703,
          "deliveryCountry": {
            "id": 703,
            "name": "Slovakia",
            "code": "SK",
            "eu": true
          }
        },
        "issueDate": "2026-03-03",
        "dueDate": "2026-03-17",
        "deliveryDate": "2026-03-03",
        "currency": {
          "id": 1,
          "symbol": "EUR",
          "name": "Euro",
          "mark": "€"
        },
        "total": 200,
        "totalWithVat": 240,
        "toBePaid": 240,
        "status": "unpaid",
        "hasVat": true
      }
    }
  ],
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "businessCaseId": 701,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Thank you for your order.",
  "textAboveItems": "Thank you for working with us.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "alreadyPaid": 0,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "willBePaid": true,
  "status": "unpaid",
  "hasVat": true,
  "items": [
    {
      "id": 1,
      "name": "Consulting",
      "description": "Monthly consulting package",
      "unitPrice": 100,
      "unitId": 1,
      "quantity": 2,
      "vatRate": 20,
      "discountName": "Loyalty discount",
      "discountType": "percentage",
      "discountValue": 10,
      "total": 200,
      "totalWithVat": 240
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
proforma
integer
required

Proforma ID.

Example:

401

Response

Proforma detail.

Proforma.

​
id
integer
Example:

401

​
uuid
string
Example:

"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

​
type
string
Example:

"proforma"

​
number
string
Example:

"20260001"

​
webDokladUrl
string<uri>

Absolute URL of the public web document for this proforma.

Example:

"https://app.fintoro.sk/web-doklad/proforma/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1"

​
pdfDownloadUrl
string<uri>

Absolute URL of the Fintoro API endpoint that downloads this proforma PDF as an attachment.

Example:

"https://app.fintoro.sk/api/public/v1/proformas/401/pdf"

​
company
object

Supplier snapshot stored directly on this document.

​
clientId
integer

Live ID of the client linked to the proforma.

Example:

101

​
client
object

Historical client snapshot stored directly on this document.

​
bankAccount
object

Bank account linked to the proforma as a live relation loaded through soft delete.

​
payments
object[]

Payments linked to this proforma ordered from newest to oldest.

​
variableSymbol
integer
Example:

20260001

​
constantSymbol
integer | null
Example:

308

​
specificSymbol
integer | null
Example:

55

​
issueDate
string<date>
Example:

"2026-03-03"

​
dueDate
string<date>
Example:

"2026-03-17"

​
businessCaseId
integer | null

Optional business case ID. When sent, it must belong to the client selected on the document.

Example:

701

​
discountType
string | null
Example:

"percentage"

​
discountValue
number<float> | null
Example:

10

​
transferTaxLiability
boolean
Example:

false

​
numericalSeriesId
integer | null
Example:

12

​
deliveryMethodId
integer

Delivery method ID from the delivery method reference table.

Example:

1

​
paymentMethodId
integer

Payment method ID from the payment method reference table.

Example:

1

​
currencyId
integer

Currency ID from the currency reference table.

Example:

1

​
languageId
integer

Language ID from the language reference table.

Example:

1

​
qrTypeId
integer

QR type ID from the QR type reference table.

Example:

1

​
note
string | null
Example:

"Thank you for your order."

​
textAboveItems
string | null
Example:

"Thank you for working with us."

​
itemsTotal
number<float>
Example:

200

​
itemsTotalWithVat
number<float>
Example:

240

​
alreadyPaid
number<float>
Example:

0

​
total
number<float>
Example:

200

​
totalWithVat
number<float>
Example:

240

​
toBePaid
number<float>
Example:

240

​
willBePaid
boolean
Example:

true

​
status
enum<string>
Available options:
paid,
unpaid,
partially_paid,
overdue,
will_not_be_paid
Example:

"unpaid"

​
hasVat
boolean
Example:

true

​
items
object[]