openapi: 3.0.3
info:
  title: 'finansi.bg - Data API Docs'
  description: "This API was created as an alternative way to consume financial data from finansi.bg.\n        It requires authentication with a valid API key that you can get by registering on the website and navigating to your profile page.\n        You get a free plan to test out the API!"
  version: 1.0.0
servers:
  -
    url: 'https://finansi.bg'
tags:
  -
    name: Endpoints
    description: ''
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: 'You can retrieve your token by visiting <a href="https://finansi.bg/profile">your profile page</a> at finansi.bg.'
security:
  -
    default: []
paths:
  /api/data/v1/statistics:
    post:
      summary: 'Get financial data for a single company'
      operationId: getFinancialDataForASingleCompany
      description: "This endpoint allows you to get detailed financial data for a single company.\nPlease look at the required Headers, Body Parameters, and Response fields to help you get started.\nWe recommend you send your first request through this page."
      parameters: []
      responses:
        200:
          description: 'Company found'
          content:
            text/plain:
              schema:
                type: string
                example: "{\n    \"is_success\": true,\n    \"company_data\": {\n        \"uic\": \"175378965\",\n        \"name\": \"КРЕСТЪН БУЛМАР\",\n        \"legal_form\": \"ООД\",\n        \"status\": \"Действащ\",\n        \"nkid_code\": \"7010\",\n        \"nkid_description\": \"Дейност на централни офиси \",\n        \"city\": \"София\",\n        \"address\": \"„Найчо Цанов“ 172\"\n    },\n    \"financial_stats\": {\n        \"latest_year\": 2023,\n        \"oldest_year\": 2008,\n        \"number_of_years\": 16\n    },\n    \"financial_data\": [\n        {\n            \"year\": \"2023\",\n            \"f01000\": 0,\n            \"f02000\": 1625,\n            \"f02100\": 1512,\n            \"f02110\": 0,\n            \"f02120\": 1512,\n            \"f02130\": 0,\n            \"f02140\": 0,\n            \"f02200\": 99,\n            \"f02210\": 0,\n            \"f02211\": 0,\n            \"f02212\": 0,\n            \"f02220\": 30,\n            \"f02230\": 69,\n            \"f02240\": 0,\n            \"f02300\": 14,\n            \"f02310\": 14,\n            \"f02320\": 0,\n            \"f02330\": 0,\n            \"f02340\": 0,\n            \"f02350\": 14,\n            \"f02353\": null,\n            \"f02360\": 0,\n            \"f02370\": 0,\n            \"f02400\": 0,\n            \"f03000\": 250,\n            \"f03100\": 0,\n            \"f03110\": 0,\n            \"f03120\": null,\n            \"f03130\": 0,\n            \"f03131\": 0,\n            \"f03132\": 0,\n            \"f03140\": 0,\n            \"f03200\": 114,\n            \"f03210\": 0,\n            \"f03220\": 114,\n            \"f03230\": 0,\n            \"f03240\": 0,\n            \"f03300\": 0,\n            \"f03400\": 136,\n            \"fs002\": 0,\n            \"fs003\": 136,\n            \"f04000\": 20,\n            \"f08500\": 1895,\n            \"f05000\": 1394,\n            \"f05100\": 250,\n            \"f05200\": 0,\n            \"f05300\": 1,\n            \"f05400\": 34,\n            \"f05500\": 911,\n            \"f05600\": 198,\n            \"f05601\": null,\n            \"f06000\": 0,\n            \"f06100\": 0,\n            \"f06200\": 0,\n            \"f06210\": 0,\n            \"f06300\": 0,\n            \"f07000\": 501,\n            \"f07001\": 501,\n            \"f07002\": 0,\n            \"f07100\": 0,\n            \"f07200\": 205,\n            \"f07201\": 205,\n            \"f07202\": 0,\n            \"f07300\": 0,\n            \"f07400\": 37,\n            \"f07500\": 0,\n            \"f07600\": 43,\n            \"f07700\": 0,\n            \"f07800\": 216,\n            \"f07810\": 44,\n            \"f07820\": 9,\n            \"f07830\": 23,\n            \"f08000\": 0,\n            \"f08001\": 0,\n            \"f08002\": 0,\n            \"f19500\": 2160,\n            \"f18000\": 2160,\n            \"f15000\": 1888,\n            \"f15100\": 1575,\n            \"f15110\": 1575,\n            \"f15120\": 0,\n            \"f15130\": 1575,\n            \"f15200\": 0,\n            \"f15300\": 300,\n            \"f15400\": 13,\n            \"f15410\": 5,\n            \"f16000\": 272,\n            \"f16100\": 272,\n            \"f16110\": 272,\n            \"f16200\": 0,\n            \"f16210\": 0,\n            \"f16300\": 0,\n            \"f16310\": 0,\n            \"f16320\": 0,\n            \"f16330\": 0,\n            \"f19000\": 49,\n            \"f19100\": 0,\n            \"f19200\": 0,\n            \"f14500\": 2160,\n            \"f13000\": 1960,\n            \"f10000\": 1937,\n            \"f10100\": 0,\n            \"f10200\": 953,\n            \"f10210\": 57,\n            \"f10220\": 896,\n            \"f10300\": 634,\n            \"f10310\": 574,\n            \"f10320\": 60,\n            \"f10321\": 45,\n            \"f10400\": 315,\n            \"f10410\": 315,\n            \"f10411\": 315,\n            \"f10412\": 0,\n            \"f10420\": 0,\n            \"f10500\": 35,\n            \"f10510\": 1,\n            \"f10520\": 0,\n            \"f11000\": 23,\n            \"f11100\": 0,\n            \"f11110\": 0,\n            \"f11200\": 23,\n            \"f11210\": 0,\n            \"f11220\": 0,\n            \"f14000\": 0,\n            \"f14100\": 200,\n            \"fs005\": 2,\n            \"f14200\": 2,\n            \"f14300\": 0,\n            \"f14400\": 198,\n            \"fs006\": null,\n            \"fs007\": null,\n            \"fs008\": null,\n            \"fs011\": null,\n            \"fs009\": null,\n            \"fs010\": 0\n        },\n        ...\n    ]\n}"
        401:
          description: Unauthenticated
          content:
            text/plain:
              schema:
                type: string
                example: "{\n    \"is_success\": false,\n    \"message\": \"No valid authentication token found.\",\n}"
        403:
          description: 'Max API usage reached'
          content:
            application/json:
              schema:
                type: object
                example:
                  is_success: false
                  message: 'You have exhausted your API usage limit.'
                properties:
                  is_success:
                    type: boolean
                    example: false
                    description: 'A flag showing whether the request was successful'
                    enum: []
                  message:
                    type: string
                    example: 'You have exhausted your API usage limit.'
        422:
          description: ''
          content:
            application/json:
              schema:
                oneOf:
                  -
                    description: 'Invalid UIC type'
                    type: object
                    example:
                      is_success: false
                      message: 'Validation errors'
                      errors:
                        uic:
                          - 'Полето uic трябва да бъде знаков низ.'
                    properties:
                      is_success:
                        type: boolean
                        example: false
                        description: 'A flag showing whether the request was successful'
                        enum: []
                      message:
                        type: string
                        example: 'Validation errors'
                      errors:
                        type: object
                        properties:
                          uic:
                            type: array
                            example:
                              - 'Полето uic трябва да бъде знаков низ.'
                            items:
                              type: string
                  -
                    description: 'Non-existing UIC'
                    type: object
                    example:
                      is_success: false
                      message: 'Validation errors'
                      errors:
                        uic:
                          - 'Избраното поле uic е невалидно.'
                    properties:
                      is_success:
                        type: boolean
                        example: false
                        description: 'A flag showing whether the request was successful'
                        enum: []
                      message:
                        type: string
                        example: 'Validation errors'
                      errors:
                        type: object
                        properties:
                          uic:
                            type: array
                            example:
                              - 'Избраното поле uic е невалидно.'
                            items:
                              type: string
        429:
          description: 'Too Many Requests'
          content:
            application/json:
              schema:
                type: object
                example:
                  is_success: false
                  message: 'You are sending too many requests.'
                properties:
                  is_success:
                    type: boolean
                    example: false
                    description: 'A flag showing whether the request was successful'
                    enum: []
                  message:
                    type: string
                    example: 'You are sending too many requests.'
      tags:
        - Endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                uic:
                  type: string
                  description: 'The UIC of the company.'
                  example: '175378965'
              required:
                - uic
  /api/data/v1/statistics/bulk:
    post:
      summary: 'Get financial data for multiple companies'
      operationId: getFinancialDataForMultipleCompanies
      description: "This endpoint allows you to get detailed financial data for up to 100 companies at ocnce.\nPlease look at the required Headers, Body Parameters, and Response fields to help you get started.\nWe recommend you send your first request through this page."
      parameters: []
      responses:
        200:
          description: 'Company found'
          content:
            text/plain:
              schema:
                type: string
                example: "{\n    \"is_success\": true,\n    \"results_for_entities\": [\n        {\n            \"type\": \"Company\",\n            \"id\": \"175378965\"\n        }\n    ],\n    \"results\": [\n        [\n            \"company_data\": {\n                \"uic\": \"175378965\",\n                \"name\": \"КРЕСТЪН БУЛМАР\",\n                \"legal_form\": \"ООД\",\n                \"status\": \"Действащ\",\n                \"nkid_code\": \"7010\",\n                \"nkid_description\": \"Дейност на централни офиси \",\n                \"city\": \"София\",\n                \"address\": \"„Найчо Цанов“ 172\"\n            },\n            \"financial_stats\": {\n                \"latest_year\": 2023,\n                \"oldest_year\": 2008,\n                \"number_of_years\": 16\n            },\n            \"financial_data\": [\n                {\n                    \"year\": \"2023\",\n                    \"f01000\": 0,\n                    \"f02000\": 1625,\n                    \"f02100\": 1512,\n                    \"f02110\": 0,\n                    \"f02120\": 1512,\n                    \"f02130\": 0,\n                    \"f02140\": 0,\n                    \"f02200\": 99,\n                    \"f02210\": 0,\n                    \"f02211\": 0,\n                    \"f02212\": 0,\n                    \"f02220\": 30,\n                    \"f02230\": 69,\n                    \"f02240\": 0,\n                    \"f02300\": 14,\n                    \"f02310\": 14,\n                    \"f02320\": 0,\n                    \"f02330\": 0,\n                    \"f02340\": 0,\n                    \"f02350\": 14,\n                    \"f02353\": null,\n                    \"f02360\": 0,\n                    \"f02370\": 0,\n                    \"f02400\": 0,\n                    \"f03000\": 250,\n                    \"f03100\": 0,\n                    \"f03110\": 0,\n                    \"f03120\": null,\n                    \"f03130\": 0,\n                    \"f03131\": 0,\n                    \"f03132\": 0,\n                    \"f03140\": 0,\n                    \"f03200\": 114,\n                    \"f03210\": 0,\n                    \"f03220\": 114,\n                    \"f03230\": 0,\n                    \"f03240\": 0,\n                    \"f03300\": 0,\n                    \"f03400\": 136,\n                    \"fs002\": 0,\n                    \"fs003\": 136,\n                    \"f04000\": 20,\n                    \"f08500\": 1895,\n                    \"f05000\": 1394,\n                    \"f05100\": 250,\n                    \"f05200\": 0,\n                    \"f05300\": 1,\n                    \"f05400\": 34,\n                    \"f05500\": 911,\n                    \"f05600\": 198,\n                    \"f05601\": null,\n                    \"f06000\": 0,\n                    \"f06100\": 0,\n                    \"f06200\": 0,\n                    \"f06210\": 0,\n                    \"f06300\": 0,\n                    \"f07000\": 501,\n                    \"f07001\": 501,\n                    \"f07002\": 0,\n                    \"f07100\": 0,\n                    \"f07200\": 205,\n                    \"f07201\": 205,\n                    \"f07202\": 0,\n                    \"f07300\": 0,\n                    \"f07400\": 37,\n                    \"f07500\": 0,\n                    \"f07600\": 43,\n                    \"f07700\": 0,\n                    \"f07800\": 216,\n                    \"f07810\": 44,\n                    \"f07820\": 9,\n                    \"f07830\": 23,\n                    \"f08000\": 0,\n                    \"f08001\": 0,\n                    \"f08002\": 0,\n                    \"f19500\": 2160,\n                    \"f18000\": 2160,\n                    \"f15000\": 1888,\n                    \"f15100\": 1575,\n                    \"f15110\": 1575,\n                    \"f15120\": 0,\n                    \"f15130\": 1575,\n                    \"f15200\": 0,\n                    \"f15300\": 300,\n                    \"f15400\": 13,\n                    \"f15410\": 5,\n                    \"f16000\": 272,\n                    \"f16100\": 272,\n                    \"f16110\": 272,\n                    \"f16200\": 0,\n                    \"f16210\": 0,\n                    \"f16300\": 0,\n                    \"f16310\": 0,\n                    \"f16320\": 0,\n                    \"f16330\": 0,\n                    \"f19000\": 49,\n                    \"f19100\": 0,\n                    \"f19200\": 0,\n                    \"f14500\": 2160,\n                    \"f13000\": 1960,\n                    \"f10000\": 1937,\n                    \"f10100\": 0,\n                    \"f10200\": 953,\n                    \"f10210\": 57,\n                    \"f10220\": 896,\n                    \"f10300\": 634,\n                    \"f10310\": 574,\n                    \"f10320\": 60,\n                    \"f10321\": 45,\n                    \"f10400\": 315,\n                    \"f10410\": 315,\n                    \"f10411\": 315,\n                    \"f10412\": 0,\n                    \"f10420\": 0,\n                    \"f10500\": 35,\n                    \"f10510\": 1,\n                    \"f10520\": 0,\n                    \"f11000\": 23,\n                    \"f11100\": 0,\n                    \"f11110\": 0,\n                    \"f11200\": 23,\n                    \"f11210\": 0,\n                    \"f11220\": 0,\n                    \"f14000\": 0,\n                    \"f14100\": 200,\n                    \"fs005\": 2,\n                    \"f14200\": 2,\n                    \"f14300\": 0,\n                    \"f14400\": 198,\n                    \"fs006\": null,\n                    \"fs007\": null,\n                    \"fs008\": null,\n                    \"fs011\": null,\n                    \"fs009\": null,\n                    \"fs010\": 0\n                },\n                ...\n            ]\n        ]\n    ]\n}"
        401:
          description: Unauthenticated
          content:
            text/plain:
              schema:
                type: string
                example: "{\n    \"is_success\": false,\n    \"message\": \"No valid authentication token found.\",\n}"
        403:
          description: 'Max API usage reached'
          content:
            application/json:
              schema:
                type: object
                example:
                  is_success: false
                  message: 'You have exhausted your API usage limit.'
                properties:
                  is_success:
                    type: boolean
                    example: false
                    description: 'A flag showing whether the request was successful'
                    enum: []
                  message:
                    type: string
                    example: 'You have exhausted your API usage limit.'
        422:
          description: ''
          content:
            application/json:
              schema:
                oneOf:
                  -
                    description: 'Invalid UIC type'
                    type: object
                    example:
                      is_success: false
                      message: 'Validation errors'
                      errors:
                        uic:
                          - 'Полето uic трябва да бъде знаков низ.'
                    properties:
                      is_success:
                        type: boolean
                        example: false
                        description: 'A flag showing whether the request was successful'
                        enum: []
                      message:
                        type: string
                        example: 'Validation errors'
                      errors:
                        type: object
                        properties:
                          uic:
                            type: array
                            example:
                              - 'Полето uic трябва да бъде знаков низ.'
                            items:
                              type: string
                  -
                    description: 'Non-existing UIC'
                    type: object
                    example:
                      is_success: false
                      message: 'Validation errors'
                      errors:
                        uic:
                          - 'Избраното поле uic е невалидно.'
                    properties:
                      is_success:
                        type: boolean
                        example: false
                        description: 'A flag showing whether the request was successful'
                        enum: []
                      message:
                        type: string
                        example: 'Validation errors'
                      errors:
                        type: object
                        properties:
                          uic:
                            type: array
                            example:
                              - 'Избраното поле uic е невалидно.'
                            items:
                              type: string
        429:
          description: 'Too Many Requests'
          content:
            application/json:
              schema:
                type: object
                example:
                  is_success: false
                  message: 'You are sending too many requests.'
                properties:
                  is_success:
                    type: boolean
                    example: false
                    description: 'A flag showing whether the request was successful'
                    enum: []
                  message:
                    type: string
                    example: 'You are sending too many requests.'
      tags:
        - Endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                uics:
                  type: array
                  description: 'The UICs of the companies.'
                  example:
                    - '175378965'
                  items:
                    type: string
              required:
                - uics
  /api/data/v1/companies/get-registry-data-by-uic:
    post:
      summary: 'Get the registry data of a company by its UIC'
      operationId: getTheRegistryDataOfACompanyByItsUIC
      description: "This endpoint allows you to get the registry data of a company by its UIC.\nPlease look at the required Headers, Body Parameters, and Response fields to help you get started.\nWe recommend you send your first request through this page."
      parameters: []
      responses:
        200:
          description: 'Company found'
          content:
            application/json:
              schema:
                type: object
                example:
                  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: []
                properties:
                  uic:
                    type: string
                    example: '175378965'
                  name:
                    type: string
                    example: 'КРЕСТЪН БУЛМАР'
                  name_transliteration:
                    type: string
                    example: 'KRESTON BULMAR OOD'
                  status:
                    type: string
                    example: действащ
                  legal_form:
                    type: string
                    example: ООД
                  creation_date:
                    type: string
                    example: 08.04.1996
                  nkid_code:
                    type: string
                    example: '7010'
                  nkid_description:
                    type: string
                    example: 'Дейност на централни офиси '
                  subject_of_activity:
                    type: string
                    example: 'Консултации и услуги в областите: счетоводство; данъци; финанси; право (без процесуално представителство); финансов и оперативен контрол; мениджмънт; маркетинг; сделки по сливане и придобиване; системи за управление; информационни и комуникационни технологии; управление на човешки ресурси; бизнес обучения и други консултации и/или услуги, относими към изброените дейности и незабранени от законодателството.'
                  vat_register_date:
                    type: string
                    example: 09.10.2007
                  capital_funds:
                    type: integer
                    example: 250000
                  deposited_funds:
                    type: integer
                    example: 250000
                  address:
                    type: object
                    properties:
                      full:
                        type: string
                        example: 'област София (столица), София 1309, район Илинден, „Найчо Цанов“ 172'
                      area:
                        type: string
                        example: 'София (столица)'
                      municipality:
                        type: string
                        example: Столична
                      city:
                        type: string
                        example: София
                      city_area:
                        type: string
                        example: 'район Илинден'
                      street:
                        type: string
                        example: '„Найчо Цанов“ 172'
                      postbox:
                        type: string
                        example: ''
                      postcode:
                        type: string
                        example: '1309'
                      eknm:
                        type: string
                        example: '68134'
                  managers:
                    type: array
                    example:
                      -
                        identification: '6710142185'
                        name: 'ЕМИЛ ГАНЧЕВ ПОПОВ'
                        role: Управител
                        country_name: БЪЛГАРИЯ
                        relevance_date: 09.11.2024
                    items:
                      type: object
                      properties:
                        identification:
                          type: string
                          example: '6710142185'
                        name:
                          type: string
                          example: 'ЕМИЛ ГАНЧЕВ ПОПОВ'
                        role:
                          type: string
                          example: Управител
                        country_name:
                          type: string
                          example: БЪЛГАРИЯ
                        relevance_date:
                          type: string
                          example: 09.11.2024
                  owners:
                    type: array
                    example:
                      -
                        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'
                    items:
                      type: object
                      properties:
                        identification:
                          type: string
                          example: '131274317'
                        name:
                          type: string
                          example: 'РОДЪТ ПОПОВ'
                        role:
                          type: string
                          example: Съдружник
                        country_name:
                          type: string
                          example: БЪЛГАРИЯ
                        relevance_date:
                          type: string
                          example: 09.11.2024
                        shares:
                          type: integer
                          example: 225000
                        percent_ownership:
                          type: string
                          example: '90.0000'
                  real_owners:
                    type: array
                    example: []
        401:
          description: Unauthenticated
          content:
            text/plain:
              schema:
                type: string
                example: "{\n    \"is_success\": false,\n    \"message\": \"No valid authentication token found.\",\n}"
        403:
          description: 'Max API usage reached'
          content:
            application/json:
              schema:
                type: object
                example:
                  is_success: false
                  message: 'You have exhausted your API usage limit.'
                properties:
                  is_success:
                    type: boolean
                    example: false
                    description: 'A flag showing whether the request was successful'
                    enum: []
                  message:
                    type: string
                    example: 'You have exhausted your API usage limit.'
        422:
          description: ''
          content:
            application/json:
              schema:
                oneOf:
                  -
                    description: 'Invalid UIC type'
                    type: object
                    example:
                      is_success: false
                      message: 'Validation errors'
                      errors:
                        uic:
                          - 'Полето uic трябва да бъде знаков низ.'
                    properties:
                      is_success:
                        type: boolean
                        example: false
                        description: 'A flag showing whether the request was successful'
                        enum: []
                      message:
                        type: string
                        example: 'Validation errors'
                      errors:
                        type: object
                        properties:
                          uic:
                            type: array
                            example:
                              - 'Полето uic трябва да бъде знаков низ.'
                            items:
                              type: string
                  -
                    description: 'Non-existing UIC'
                    type: object
                    example:
                      is_success: false
                      message: 'Validation errors'
                      errors:
                        uic:
                          - 'Избраното поле uic е невалидно.'
                    properties:
                      is_success:
                        type: boolean
                        example: false
                        description: 'A flag showing whether the request was successful'
                        enum: []
                      message:
                        type: string
                        example: 'Validation errors'
                      errors:
                        type: object
                        properties:
                          uic:
                            type: array
                            example:
                              - 'Избраното поле uic е невалидно.'
                            items:
                              type: string
        429:
          description: 'Too Many Requests'
          content:
            application/json:
              schema:
                type: object
                example:
                  is_success: false
                  message: 'You are sending too many requests.'
                properties:
                  is_success:
                    type: boolean
                    example: false
                    description: 'A flag showing whether the request was successful'
                    enum: []
                  message:
                    type: string
                    example: 'You are sending too many requests.'
      tags:
        - Endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                uic:
                  type: string
                  description: 'The UIC of the company.'
                  example: '175378965'
              required:
                - uic
