Quick Examples

NOTE: Please note that in order to test the API Call from the examples, you would need to add your token after “token=” in the API call.

Search for companies based on predefined criteria

Use Case: You are interested in companies which are operating in the industry of Automobile Manufacturing in China. In order to get the relevant results you can follow the steps below:

  1. Use the Dictionary GET /DICTIONARY/INDUSTRIES/CLASSES/{CLASS_CODE} in order to get the NAICS code for Automobile Manufacturing https://api.emis.com/v2/company/dictionary/industries/classes/naics?token=
    image
  2. Use the GET /COMPANIES method in order to search for companies with the criteria main_industry = ‘3361’, which stands for ‘Motor Vehicle Manufacturing’ and country = ‘CN’ for China. https://api.emis.com/v2/company/companies?country=CN&main_industry=3361&token=
    image
  3. We have found around 900 results. In order to get company details for each company in the search result output you can use the company identifier ‘{id} ‘ and use the GET /COMPANIES/{ID} method to retrieve the company profile data
  4. API Call:
    https://api.emis.com/v2/company/companies/12922588?token=

    image

Get list of companies in India with Total Assets above 5,000,000 USD

Use Case: You are interested which companies from India that have a lower limit of 5 mln USD in Total Assets. You can use the company search method GET /COMPANIES with parameters country = ‘IN’ and TS[from] = 5,000,000 with the currency parameter being USD by default.

Api Call:
https://api.emis.com/v2/company/companies?country=IN&TS[from]=5000000&token=

Search for companies by certain criteria

Use_Case: You are interested by Brazilian companies with owner from Columbia. To get the extended list of companies use Search/queryCompany functionality.

API Call:
https://api.emis.com/company//Search/queryCompany/?filter[]=country:BR&filter[]=owner_country:CO&extended=true&token=
Test Example Interactive Doc

image

Match a company using an external Identifier

Use Case: You are interested in checking if EMIS’ database has a specific Polish company. Rather than using keyword search for the company name, you want to get an exact match using a KRS code.:

  1. Find the company EMIS id (isic) by using the method GET /COMPANIES/MATCH functionality. The method allows to search for companies and get an estimated match with a score showing the accuracy of the matching result.
    API Call:
    https://api.emis.com/v2/company/companies/match?country_code=PL&external_id=0000164776&token=
    image
    Output of the method:
    image

Get the financial statements available for a specific Colombian company

Use Case: You are interested in analysing the financial information of Koba Colombia SAS. You have already identified that it is available in the database using the GET /COMPANIES method.:

  1. Use the EMIS Id of the company to search for available financials using GET /COMPANIES/{ID}/STATEMENTS which returns a full list of financial statements for a given company ID for the past 10 years.

  2. API Call:
    https://api.emis.com/v2/company/companies/3524378/statements?token=

    image
    Output of the method:
    image
  3. Using the API call output you can get information on the available financials, their unique statement ids and the available financial standards that are supported (Global & Local).You can use the GET /COMPANIES/STATEMENTS/{ID}/ACCOUNTS/{STANDARD_ID} method to get the detailed accounts information in the standard structure you need. You can add an additional parameter currency = COP to get the data in local currency.
    API Call:
    https://api.emis.com/v2/company/companies/statements/42471984/accounts/100?currency=COP&token=
    image
    image