IntroductionQuickstartAuthenticationPaginationRate Limit

Search endpoints

Job Search POSTCompany Search POSTTechnographics POST

Account endpoints

Get Credit Balance GETGet Credits Consumption GET

Other

Get Companies Per Company Country Code GETGet Industries GETGet Jobs And Companies Per Job Country Code GETGet Geographic Locations GETList Technologies GETGet Industries GETList Technology Categories GETList Technology Subcategories GET
TheirStack TheirStack Logo
DocumentationAPI ReferenceWebhooksDatasetsMCPGuides
Catalog

Get Companies Per Company Country Code

This endpoint will return all country codes and the number of companies whose HQ is in that country.

Calls to this endpoint don't cost you credits.

GET
/v0/catalog/companies_per_company_country_code

Query Parameters

  • country
    stringnullable

    Name of a country. Will return the country matching their name in English

  • page
    integer
    0 <= valuedefault: 0

    Page number.

  • limit
    integer
    1 <= valuedefault: 25

    Number of results per page

  • Response Body

    application/json

    application/json

    application/json

    application/json

    application/json

    curl -X GET "https://api.theirstack.com/v0/catalog/companies_per_company_country_code"
    {
      "data": [
        {
          "iso2": "string",
          "country": "string",
          "num_companies": 0
        }
      ],
      "metadata": {
        "total_results": 2034
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }

    How is this guide?

    Last updated on

    Get Credits Consumption GET

    Get the API records returned per day

    Get Industries GET

    This endpoint lets you list all the industries and their codes, see how many jobs and companies we have per industry and search for an industry.