List countries

Return every company-country name and ISO 3166 code in one response: no pagination. Each country includes the number of symbols of companies domiciled there, counting every exchange listing of each company. Use both fields when you need a display label and a compact filter value.

GET/v3.0.0/countries

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Parameters

Response

Response fields

dataarray of objects

Array of every country resource, ordered by name.

+ Show child attributes
idstring

Unique identifier for the country, beginning with cty_. Derived deterministically from code and name, so it never changes for a given country and is safe to store in your database.

objectstring

String representing the object's type, always v3.reference.country for this resource.

namestring

English name of the country the company is domiciled in, e.g. United States.

codestring

Two-letter ISO 3166 country code, e.g. US. Matches the company-profile address country_code; company domicile can differ from the listing_country_code of a ticker.

symbol_countnumber

Number of symbols of companies domiciled in this country, counting every exchange listing of each company.

next_page_urlnullable

Always null: the endpoint returns the complete catalog in one response.

previous_page_urlnullable

Always null: the endpoint returns the complete catalog in one response.

Related endpoints

Company profiles include company and address country fields that align with this catalog. For the country of a listing exchange, use the market catalog instead.

Request
curl "https://api.roic.ai/v3.0.0/countries?apikey=YOUR_API_KEY"
Response
200 OK
{
  "data": [
    {
      "id": "cty_ybeNtUvgWjwsHDz3d4387S",
      "object": "v3.reference.country",
      "name": "United States",
      "code": "US",
      "symbol_count": 22118
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}