List Companies

Retrieve a paginated list of companies.
Supports filtering via various query parameters including:

GICS classifications: sector, industry_group, industry, sub_industry (by GICS codes).

Location: countries (comma-separated ISO Alpha-2 codes, e.g., US,GB).

Identifiers: isin, lei, ticker (all case-insensitive).

Supports searching via the search parameter across company name, ISINs, LEI, and Ticker.
Supports ordering via the ordering parameter. Allowed fields for ordering are: name, date_ipo, year_founded, and country_iso__name. For example, ?ordering=name or ?ordering=-date_ipo for descending order.

Request

Query Params

countries

string

optional

Filter by Company country ISO Alpha-2 code(s). Comma-separated for multiple values (e.g., US,GB,DE).

industry

string

optional

Filter by GICS Industry code.

industry_group

string

optional

Filter by GICS Industry Group code.

isin

string

optional

Find companies matching the provided ISIN.

lei

string

optional

Find a company by its LEI.

ordering

string

optional

Which field to use when ordering the results.

page

integer

optional

A page number within the paginated result set.

page_size

integer

optional

Number of results to return per page.

string

optional

A search term.

sector

string

optional

Filter by GICS Sector code.

sub_industry

string

optional

Filter by GICS Sub-Industry code.

ticker

string

optional

Find a company by its Ticker.

Header Params

x-api-key

string

required

Responses

🟢200OK

application/json

Successfully retrieved the list of companies.

Body

count

integer

required

Example:

123

string <uri> | null

optional

Example:

http://api.example.org/accounts/?page=4

string <uri> | null

optional

Example:

http://api.example.org/accounts/?page=2

results

array[object (Company) {29}]

required

integer

read-onlyrequired

Unique identifier for the company.

name

string

read-onlyrequired

Company name.

lei

string

read-onlyrequired

Legal Entity Identifier (ISO 17442).

country_code

string | null

read-onlyrequired

ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters.

sector

null | allOf {1}

read-onlyrequired

Company's GICS Sector classification.

industry_group

null | allOf {1}

read-onlyrequired

Company's GICS Industry Group classification.

industry

null | allOf {1}

read-onlyrequired

Company's GICS Industry classification.

sub_industry

null | allOf {1}

read-onlyrequired

Company's GICS Sub-Industry classification.

ir_link

string <uri>

read-onlyrequired

Link to the company's Investor Relations page.

homepage_link

string <uri>

read-onlyrequired

Link to the company's main homepage.

date_public

string <date> | null

read-onlyrequired

Date the company first became public.

date_ipo

string <date>

read-onlyrequired

Date of the company's Initial Public Offering.

main_stock_exchange

string

read-onlyrequired

Primary stock exchange where the company is listed.

social_facebook

string <uri> | null

read-onlyrequired

Facebook profile/page identifier.

social_instagram

string <uri> | null

read-onlyrequired

Instagram profile identifier.

social_twitter

string <uri> | null

read-onlyrequired

Twitter handle (without @).

social_linkedin

string <uri> | null

read-onlyrequired

LinkedIn company page identifier/URL path.

social_youtube

string <uri> | null

read-onlyrequired

YouTube channel identifier.

social_tiktok

string <uri> | null

read-onlyrequired

TikTok profile identifier.

social_pinterest

string <uri> | null

read-onlyrequired

Pinterest profile identifier.

social_xing

string <uri> | null

read-onlyrequired

Xing company profile identifier.

social_glassdoor

string <uri> | null

read-onlyrequired

Glassdoor company identifier.

year_founded

string <date> | null

read-onlyrequired

Date the company was founded.

corporate_video_id

string | null

read-onlyrequired

Identifier for a corporate video (e.g., YouTube ID).

served_area

string | null

read-onlyrequired

Geographical area served by the company.

headcount

integer | null

read-onlyrequired

Approximate number of employees.

contact_email

string <email> | null

read-onlyrequired

General contact email address.

ticker

string | null

read-onlyrequired

Primary stock ticker symbol.

is_listed

boolean

read-onlyrequired

Indicates if the company is currently publicly listed.

Example

{
    "count": 123,
    "next": "http://api.example.org/accounts/?page=4",
    "previous": "http://api.example.org/accounts/?page=2",
    "results": [
        {
            "id": 0,
            "name": "string",
            "lei": "string",
            "country_code": "string",
            "sector": {
                "code": "string",
                "name": "string"
            },
            "industry_group": {
                "code": "string",
                "name": "string",
                "sector": {
                    "code": "string",
                    "name": "string"
                }
            },
            "industry": {
                "code": "string",
                "name": "string",
                "industry_group": {
                    "code": "string",
                    "name": "string",
                    "sector": {
                        "code": "string",
                        "name": "string"
                    }
                }
            },
            "sub_industry": {
                "code": "string",
                "name": "string",
                "industry": {}
            },
            "ir_link": "http://example.com",
            "homepage_link": "http://example.com",
            "date_public": "2019-08-24",
            "date_ipo": "2019-08-24",
            "main_stock_exchange": "string",
            "social_facebook": "http://example.com",
            "social_instagram": "http://example.com",
            "social_twitter": "http://example.com",
            "social_linkedin": "http://example.com",
            "social_youtube": "http://example.com",
            "social_tiktok": "http://example.com",
            "social_pinterest": "http://example.com",
            "social_xing": "http://example.com",
            "social_glassdoor": "http://example.com",
            "year_founded": "2019-08-24",
            "corporate_video_id": "string",
            "served_area": "string",
            "headcount": 0,
            "contact_email": "user@example.com",
            "ticker": "string",
            "is_listed": true
        }
    ]
}

Request

Request samples

Responses