---
title: "Count Companies By Country"
method: GET
path: "/v0/catalog/companies_per_company_country_code"
tags: ["Catalog"]
---

# Count Companies By Country

`GET /v0/catalog/companies_per_company_country_code`

## Request

- Base URL: `https://api.theirstack.com`
- URL: `https://api.theirstack.com/v0/catalog/companies_per_company_country_code`
- Auth: none declared

List every ISO country code with the number of companies headquartered in that country, for geographic distribution analysis. Free: it doesn't consume credits.

## Query parameters

- `country` string, nullable: Name of a country. Will return the country matching their name in English
- `page` integer: Page number.
- `limit` integer: Number of results per page

## Response `200`

Successful Response

- CompaniesPerCountryCodeResponse
  - `data` CompaniesPerCountryCode[], required
    - `iso2` string, nullable: ISO2 country code
    - `country` string, nullable: Country name
    - `num_companies` integer, nullable: Number of companies in the country
  - `metadata` BaseMetadata, required
    - `total_results` integer, nullable: Total number of results

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `422`: Unprocessable Content
- `500`: Internal Server Error

## Changes

- **2026-01-14** `ecd1eb029865`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/catalog/companies_per_company_country_code/get.md)

---

[API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) - [All operations](https://skmtc.dev/theirstack/apis/theirstack-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/theirstack/apis/theirstack-api-reference/revisions/4f3da5ce4026?raw)