---
title: "Get Companies Per Company Country Code"
method: GET
path: "/v0/catalog/companies_per_company_country_code"
tags: ["Catalog"]
---

# Get Companies Per Company Country Code

`GET /v0/catalog/companies_per_company_country_code`

Retrieve all ISO country codes with the number of companies headquartered in each country. Use this endpoint for geographic distribution analysis. Calls to this endpoint are free and do not consume any API 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

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/revisions/de22d7240734/schema)