Celebrating 15th Spring

Business API

Web Service to Access Business Data

Service description



The Web API allows other applications to access the business information from the MarketAlerts Database. Software robots and enterprise solutions, such as ERPs or CRMs, have professional access to business data in JSON format.

To use the Business API, a PRO subscription is required.




 

 

Base URL



To access the API service, use the following URL address:
https://marketalerts.ro/web/business.api


 

 

Authentication



The default authentication is based on the (external) IP address of the device that initiated the API request.

Additionally, the requests can be authenticated using licence tokens called API Keys.


 

 

Request



A valid HTTP request should observe these criteria:
  1. Method - the API service should be requested using POST method. For demo purposes only, with limitations, GET method can be used;
  2. Header - should contain media type Content-Type: application/x-www-form-urlencoded and Content-Length of the post data;
  3. Parameters - the request can include these parameters:
    • code - required: fiscal code of the company
    • years - optional: number of previous years for the financial data - maximum 6 years, default 1 year
    • target - optional: the plus-delimited desired data sections of the request:
      • basics - general information about the company
      • financials - financial data for the requested years
      • overdues - overdue debts to State for the current and previous reported quarters

      When target parameter is missing the API returns basics section only.

A simple API request looks like this:
POST /web/business.api HTTP/1.1
Host: marketalerts.ro
Content-Type: application/x-www-form-urlencoded
Content-Length: 12

code=8971726

while a complete API request looks like this:
POST /web/business.api HTTP/1.1
Host: marketalerts.ro
Content-Type: application/x-www-form-urlencoded
Content-Length: 54

code=8971726&years=6&target=basics+financials+overdues


 

 

Response



A properly formed and authenticated API request should receive a server response in JSON format, with straightforward fields.

The first section included in the response is the result section with three response attributes:
  • id: the fiscal code of the company, if no errors occurred
  • message: the textual result of the API request, either success, error or error description
  • error: the error code, if any or zero otherwise

When financials section is requested, the response will also include a business section with the description of the business activity NACE | CAEN code(s), in both Romanian and English languages.

A simple response looks like this:
{
    "result": {
        "id": 9010105,
        "message": "success",
        "error": 0
    },
    "basics": {
        "company": "ORANGE ROMANIA SA",
        "county": "Bucuresti",
        "locality": "Bucureşti",
        "district": "1",
        "street": "B-dul Lascar Catargiu",
        "number": "47-53",
        "tradeRegister": "J40\/10178\/1996",
        "zip": "",
        "phone": "0213177919",
        "fax": "0374447173",
        "status": "registered",
        "statusDate": "1996-12-04"
    },
    "financials": {},
    "business": {},
    "overdues": {}
}

while a complete response looks like this:
{
    "result": {
        "id": 8678166,
        "message": "success",
        "error": 0
    },
    "basics": {
        "company": "ABIS STUDIO SRL",
        "county": "Bucuresti",
        "locality": "Bucureşti",
        "district": "1",
        "street": "Str. Emanoil Porumbaru",
        "number": "27",
        "tradeRegister": "J40\/6586\/1996",
        "postalCode": "11422",
        "phone": "0722525535",
        "fax": "",
        "status": "registered",
        "statusDate": "1996-08-01"
    },
    "financials": {
        "2018": {
            "caen": 5911,
            "fixedAssets": 17983374,
            "currentAssets": 11739847,
            "stocks": 459328,
            "cash": 106103,
            "receivables": 11174416,
            "equity": 2339847,
            "socialCapital": 20000,
            "totalDebts": 16608212,
            "turnover": 18819347,
            "netProfit": 1106005,
            "employees": 18
        },
        "2017": {
            "caen": 5911,
            "fixedAssets": 10427649,
            "currentAssets": 6652127,
            "stocks": 484669,
            "cash": 510394,
            "receivables": 5657064,
            "equity": 1233842,
            "socialCapital": 20000,
            "totalDebts": 16007024,
            "turnover": 22586789,
            "netProfit": 996255,
            "employees": 17
        },
        "2016": {
            "caen": 5911,
            "fixedAssets": 10270123,
            "currentAssets": 6144379,
            "stocks": 514605,
            "cash": 26962,
            "receivables": 5602812,
            "equity": 237587,
            "socialCapital": 20000,
            "totalDebts": 16198642,
            "turnover": 21659782,
            "netProfit": 1433788,
            "employees": 13
        },
        "2015": {
            "caen": 5911,
            "fixedAssets": 9815315,
            "currentAssets": 5611182,
            "stocks": 538171,
            "cash": 63463,
            "receivables": 5009548,
            "equity": -1196201,
            "socialCapital": 20000,
            "totalDebts": 17415283,
            "turnover": 24346046,
            "netProfit": 1100771,
            "employees": 15
        },
        "2014": {
            "caen": 5911,
            "fixedAssets": 6988702,
            "currentAssets": 4953568,
            "stocks": 0,
            "cash": 197309,
            "receivables": 4756259,
            "equity": -2296972,
            "socialCapital": 20000,
            "totalDebts": 14383363,
            "turnover": 15829334,
            "netProfit": -1547678,
            "employees": 16
        },
        "2013": {
            "caen": 5911,
            "fixedAssets": 7223392,
            "currentAssets": 3707626,
            "stocks": 4343,
            "cash": 7202,
            "receivables": 3696081,
            "equity": -749293,
            "socialCapital": 20000,
            "totalDebts": 11662093,
            "turnover": 12784239,
            "netProfit": -222429,
            "employees": 24
        }
    },
    "business": {
        "5911": {
            "ro": "Activitati de productie cinematografica, video si de programe de televiziune",
            "en": "Motion picture, video and television programme production activities"
        }
    },
    "overdues": {
        "current": {
            "date": "2019-12-31",
            "amount": 305273
        },
        "previous": {
            "date": "2019-09-30",
            "amount": 0
        }
    }
}

Notes:

- financial data and overdues to State are returned in RON;

- the amount in overdues displays positive values only when data are available, i.e. have been listed by fiscal authorities based on the publishing criteria.


 

 

Subscription



To benefit from the Business API service, a PRO subscription is required. See the special offers and the discount for our VIP subscribers on the subscription page.

Feel free to contact us for more details.


 
 
* * *