finansi.bg - Data API Docs

Postman collection → OpenAPI spec →

Introduction

This API was created as an alternative way to consume financial data from finansi.bg. It requires authentication with a valid API key that you can get by registering on the website and navigating to your profile page. You get a free plan to test out the API!

There's a default limit of 60 requests per minute. If you need more, you should reach out to us at [email protected].

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your profile page at finansi.bg.

Endpoints

Get financial data for a single company

POST
https://finansi.bg
/api/data/v1/statistics
requires authentication

This endpoint allows you to get detailed financial data for a single company. Please look at the required Headers, Body Parameters, and Response fields to help you get started. We recommend you send your first request through this page.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

Body Parameters

Response Fields

Example request: 
curl --request POST \
    "https://finansi.bg/api/data/v1/statistics" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"uic\": \"175378965\"
}"
Example response:
{
    "is_success": true,
    "company_data": {
        "uic": "175378965",
        "name": "КРЕСТЪН БУЛМАР",
        "legal_form": "ООД",
        "status": "Действащ",
        "nkid_code": "7010",
        "nkid_description": "Дейност на централни офиси ",
        "city": "София",
        "address": "„Найчо Цанов“ 172"
    },
    "financial_stats": {
        "latest_year": 2023,
        "oldest_year": 2008,
        "number_of_years": 16
    },
    "financial_data": [
        {
            "year": "2023",
            "f01000": 0,
            "f02000": 1625,
            "f02100": 1512,
            "f02110": 0,
            "f02120": 1512,
            "f02130": 0,
            "f02140": 0,
            "f02200": 99,
            "f02210": 0,
            "f02211": 0,
            "f02212": 0,
            "f02220": 30,
            "f02230": 69,
            "f02240": 0,
            "f02300": 14,
            "f02310": 14,
            "f02320": 0,
            "f02330": 0,
            "f02340": 0,
            "f02350": 14,
            "f02353": null,
            "f02360": 0,
            "f02370": 0,
            "f02400": 0,
            "f03000": 250,
            "f03100": 0,
            "f03110": 0,
            "f03120": null,
            "f03130": 0,
            "f03131": 0,
            "f03132": 0,
            "f03140": 0,
            "f03200": 114,
            "f03210": 0,
            "f03220": 114,
            "f03230": 0,
            "f03240": 0,
            "f03300": 0,
            "f03400": 136,
            "fs002": 0,
            "fs003": 136,
            "f04000": 20,
            "f08500": 1895,
            "f05000": 1394,
            "f05100": 250,
            "f05200": 0,
            "f05300": 1,
            "f05400": 34,
            "f05500": 911,
            "f05600": 198,
            "f05601": null,
            "f06000": 0,
            "f06100": 0,
            "f06200": 0,
            "f06210": 0,
            "f06300": 0,
            "f07000": 501,
            "f07001": 501,
            "f07002": 0,
            "f07100": 0,
            "f07200": 205,
            "f07201": 205,
            "f07202": 0,
            "f07300": 0,
            "f07400": 37,
            "f07500": 0,
            "f07600": 43,
            "f07700": 0,
            "f07800": 216,
            "f07810": 44,
            "f07820": 9,
            "f07830": 23,
            "f08000": 0,
            "f08001": 0,
            "f08002": 0,
            "f19500": 2160,
            "f18000": 2160,
            "f15000": 1888,
            "f15100": 1575,
            "f15110": 1575,
            "f15120": 0,
            "f15130": 1575,
            "f15200": 0,
            "f15300": 300,
            "f15400": 13,
            "f15410": 5,
            "f16000": 272,
            "f16100": 272,
            "f16110": 272,
            "f16200": 0,
            "f16210": 0,
            "f16300": 0,
            "f16310": 0,
            "f16320": 0,
            "f16330": 0,
            "f19000": 49,
            "f19100": 0,
            "f19200": 0,
            "f14500": 2160,
            "f13000": 1960,
            "f10000": 1937,
            "f10100": 0,
            "f10200": 953,
            "f10210": 57,
            "f10220": 896,
            "f10300": 634,
            "f10310": 574,
            "f10320": 60,
            "f10321": 45,
            "f10400": 315,
            "f10410": 315,
            "f10411": 315,
            "f10412": 0,
            "f10420": 0,
            "f10500": 35,
            "f10510": 1,
            "f10520": 0,
            "f11000": 23,
            "f11100": 0,
            "f11110": 0,
            "f11200": 23,
            "f11210": 0,
            "f11220": 0,
            "f14000": 0,
            "f14100": 200,
            "fs005": 2,
            "f14200": 2,
            "f14300": 0,
            "f14400": 198,
            "fs006": null,
            "fs007": null,
            "fs008": null,
            "fs011": null,
            "fs009": null,
            "fs010": 0
        },
        ...
    ]
}
{
    "is_success": false,
    "message": "No valid authentication token found.",
}
{
    "is_success": false,
    "message": "You have exhausted your API usage limit."
}
{
    "is_success": false,
    "message": "Validation errors",
    "errors": {
        "uic": [
            "Полето uic трябва да бъде знаков низ."
        ]
    }
}
{
    "is_success": false,
    "message": "Validation errors",
    "errors": {
        "uic": [
            "Избраното поле uic е невалидно."
        ]
    }
}
{
    "is_success": false,
    "message": "You are sending too many requests."
}

Get financial data for multiple companies

POST
https://finansi.bg
/api/data/v1/statistics/bulk
requires authentication

This endpoint allows you to get detailed financial data for up to 100 companies at ocnce. Please look at the required Headers, Body Parameters, and Response fields to help you get started. We recommend you send your first request through this page.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

Body Parameters

Response Fields

Example request: 
curl --request POST \
    "https://finansi.bg/api/data/v1/statistics/bulk" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"uics\": [
        \"175378965\"
    ]
}"
Example response:
{
    "is_success": true,
    "results_for_entities": [
        {
            "type": "Company",
            "id": "175378965"
        }
    ],
    "results": [
        [
            "company_data": {
                "uic": "175378965",
                "name": "КРЕСТЪН БУЛМАР",
                "legal_form": "ООД",
                "status": "Действащ",
                "nkid_code": "7010",
                "nkid_description": "Дейност на централни офиси ",
                "city": "София",
                "address": "„Найчо Цанов“ 172"
            },
            "financial_stats": {
                "latest_year": 2023,
                "oldest_year": 2008,
                "number_of_years": 16
            },
            "financial_data": [
                {
                    "year": "2023",
                    "f01000": 0,
                    "f02000": 1625,
                    "f02100": 1512,
                    "f02110": 0,
                    "f02120": 1512,
                    "f02130": 0,
                    "f02140": 0,
                    "f02200": 99,
                    "f02210": 0,
                    "f02211": 0,
                    "f02212": 0,
                    "f02220": 30,
                    "f02230": 69,
                    "f02240": 0,
                    "f02300": 14,
                    "f02310": 14,
                    "f02320": 0,
                    "f02330": 0,
                    "f02340": 0,
                    "f02350": 14,
                    "f02353": null,
                    "f02360": 0,
                    "f02370": 0,
                    "f02400": 0,
                    "f03000": 250,
                    "f03100": 0,
                    "f03110": 0,
                    "f03120": null,
                    "f03130": 0,
                    "f03131": 0,
                    "f03132": 0,
                    "f03140": 0,
                    "f03200": 114,
                    "f03210": 0,
                    "f03220": 114,
                    "f03230": 0,
                    "f03240": 0,
                    "f03300": 0,
                    "f03400": 136,
                    "fs002": 0,
                    "fs003": 136,
                    "f04000": 20,
                    "f08500": 1895,
                    "f05000": 1394,
                    "f05100": 250,
                    "f05200": 0,
                    "f05300": 1,
                    "f05400": 34,
                    "f05500": 911,
                    "f05600": 198,
                    "f05601": null,
                    "f06000": 0,
                    "f06100": 0,
                    "f06200": 0,
                    "f06210": 0,
                    "f06300": 0,
                    "f07000": 501,
                    "f07001": 501,
                    "f07002": 0,
                    "f07100": 0,
                    "f07200": 205,
                    "f07201": 205,
                    "f07202": 0,
                    "f07300": 0,
                    "f07400": 37,
                    "f07500": 0,
                    "f07600": 43,
                    "f07700": 0,
                    "f07800": 216,
                    "f07810": 44,
                    "f07820": 9,
                    "f07830": 23,
                    "f08000": 0,
                    "f08001": 0,
                    "f08002": 0,
                    "f19500": 2160,
                    "f18000": 2160,
                    "f15000": 1888,
                    "f15100": 1575,
                    "f15110": 1575,
                    "f15120": 0,
                    "f15130": 1575,
                    "f15200": 0,
                    "f15300": 300,
                    "f15400": 13,
                    "f15410": 5,
                    "f16000": 272,
                    "f16100": 272,
                    "f16110": 272,
                    "f16200": 0,
                    "f16210": 0,
                    "f16300": 0,
                    "f16310": 0,
                    "f16320": 0,
                    "f16330": 0,
                    "f19000": 49,
                    "f19100": 0,
                    "f19200": 0,
                    "f14500": 2160,
                    "f13000": 1960,
                    "f10000": 1937,
                    "f10100": 0,
                    "f10200": 953,
                    "f10210": 57,
                    "f10220": 896,
                    "f10300": 634,
                    "f10310": 574,
                    "f10320": 60,
                    "f10321": 45,
                    "f10400": 315,
                    "f10410": 315,
                    "f10411": 315,
                    "f10412": 0,
                    "f10420": 0,
                    "f10500": 35,
                    "f10510": 1,
                    "f10520": 0,
                    "f11000": 23,
                    "f11100": 0,
                    "f11110": 0,
                    "f11200": 23,
                    "f11210": 0,
                    "f11220": 0,
                    "f14000": 0,
                    "f14100": 200,
                    "fs005": 2,
                    "f14200": 2,
                    "f14300": 0,
                    "f14400": 198,
                    "fs006": null,
                    "fs007": null,
                    "fs008": null,
                    "fs011": null,
                    "fs009": null,
                    "fs010": 0
                },
                ...
            ]
        ]
    ]
}
{
    "is_success": false,
    "message": "No valid authentication token found.",
}
{
    "is_success": false,
    "message": "You have exhausted your API usage limit."
}
{
    "is_success": false,
    "message": "Validation errors",
    "errors": {
        "uic": [
            "Полето uic трябва да бъде знаков низ."
        ]
    }
}
{
    "is_success": false,
    "message": "Validation errors",
    "errors": {
        "uic": [
            "Избраното поле uic е невалидно."
        ]
    }
}
{
    "is_success": false,
    "message": "You are sending too many requests."
}

Get the registry data of a company by its UIC

POST
https://finansi.bg
/api/data/v1/companies/get-registry-data-by-uic
requires authentication

This endpoint allows you to get the registry data of a company by its UIC. Please look at the required Headers, Body Parameters, and Response fields to help you get started. We recommend you send your first request through this page.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

Body Parameters

Response Fields

Example request: 
curl --request POST \
    "https://finansi.bg/api/data/v1/companies/get-registry-data-by-uic" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"uic\": \"175378965\"
}"
Example response:
{
    "uic": "175378965",
    "name": "КРЕСТЪН БУЛМАР",
    "name_transliteration": "KRESTON BULMAR OOD",
    "status": "действащ",
    "legal_form": "ООД",
    "creation_date": "08.04.1996",
    "nkid_code": "7010",
    "nkid_description": "Дейност на централни офиси ",
    "subject_of_activity": "Консултации и услуги в областите: счетоводство; данъци; финанси; право (без процесуално представителство); финансов и оперативен контрол; мениджмънт; маркетинг; сделки по сливане и придобиване; системи за управление; информационни и комуникационни технологии; управление на човешки ресурси; бизнес обучения и други консултации и/или услуги, относими към изброените дейности и незабранени от законодателството.",
    "vat_register_date": "09.10.2007",
    "capital_funds": 250000,
    "deposited_funds": 250000,
    "address": {
        "full": "област София (столица), София 1309, район Илинден, „Найчо Цанов“ 172",
        "area": "София (столица)",
        "municipality": "Столична",
        "city": "София",
        "city_area": "район Илинден",
        "street": "„Найчо Цанов“ 172",
        "postbox": "",
        "postcode": "1309",
        "eknm": "68134"
    },
    "managers": [
        {
            "identification": "6710142185",
            "name": "ЕМИЛ ГАНЧЕВ ПОПОВ",
            "role": "Управител",
            "country_name": "БЪЛГАРИЯ",
            "relevance_date": "09.11.2024"
        }
    ],
    "owners": [
        {
            "identification": "131274317",
            "name": "РОДЪТ ПОПОВ",
            "role": "Съдружник",
            "country_name": "БЪЛГАРИЯ",
            "relevance_date": "09.11.2024",
            "shares": 225000,
            "percent_ownership": "90.0000"
        },
        {
            "identification": "177233356",
            "name": "ФОНДАЦИЯ ФОНДАЦИЯ МУЗЕЙ НА СЧЕТОВОДСТВОТО",
            "role": "Съдружник",
            "country_name": "БЪЛГАРИЯ",
            "relevance_date": "09.11.2024",
            "shares": 25000,
            "percent_ownership": "10.0000"
        }
    ],
    "real_owners": []
}
{
    "is_success": false,
    "message": "No valid authentication token found.",
}
{
    "is_success": false,
    "message": "You have exhausted your API usage limit."
}
{
    "is_success": false,
    "message": "Validation errors",
    "errors": {
        "uic": [
            "Полето uic трябва да бъде знаков низ."
        ]
    }
}
{
    "is_success": false,
    "message": "Validation errors",
    "errors": {
        "uic": [
            "Избраното поле uic е невалидно."
        ]
    }
}
{
    "is_success": false,
    "message": "You are sending too many requests."
}