---
updatedAt: 2026-06-04T10:32:52.000Z
agentTools:
  projectIndex: https://docs.companyenrich.com/llms.txt
---

# Scroll

**Cost:** 1 credit per company returned. 1 credit minimum if no results are found.

Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more.
At most 100 companies are returned per request.

You can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set.
In case on no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results.

This will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results.

# OpenAPI definition

````json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Enrich API",
    "description": "The Company Enrich API provides programmatic access to a comprehensive database of company and person data for enrichment, search, and lead generation.\n\n## Key Features\n\n- **Company Enrichment** — Enrich company profiles by domain, ID, or matching properties. Supports single lookups, batch requests, and bulk background jobs.\n- **Company Search** — Search and filter companies by industry, location, size, technology usage, keywords, and more. Supports page-based, cursor-based, and async export pagination.\n- **People Search** — Search for professionals by job title, company, location, and other criteria. Export results in CSV or JSON.\n- **Similar Companies** — Find companies similar to a given company based on shared attributes.\n- **Company Lists** — Create and manage saved lists of companies for organizing and exporting your data.\n\n## Authentication\n\nAll API requests require a Bearer token passed in the `Authorization` header:\n\n```\nAuthorization: Bearer YOUR_API_TOKEN\n```\n\nYou can generate API tokens from your [dashboard](https://companyenrich.com/dashboard).\n\n## Credits\n\nMost API calls consume credits. The credit cost for each endpoint is documented in its description. You can check your remaining credit balance using the User endpoint.\n\n## Rate Limiting\n\nThe global API limiter allows **500 requests per minute** per IP address. Authenticated API routes also use a per-user route limiter based on plan capabilities.\nSupplementary lookup endpoints (such as keyword/technology/industry autocompletes) use a separate per-user route-level bucket.",
    "termsOfService": "https://companyenrich.com/terms-and-conditions",
    "contact": {
      "url": "https://companyenrich.com/",
      "email": "support@companyenrich.com"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.companyenrich.com"
    }
  ],
  "paths": {
    "/companies/search/scroll": {
      "post": {
        "tags": [
          "Company / Search"
        ],
        "summary": "Scroll",
        "description": "**Cost:** 1 credit per company returned. 1 credit minimum if no results are found.\n\nSearches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more.\nAt most 100 companies are returned per request.\n\nYou can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set.\nIn case on no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results.\n\nThis will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results.",
        "parameters": [
          {
            "name": "expand",
            "in": "query",
            "description": "Expandable response fields. Repeat the parameter to request multiple expansions.\n\nSupported values:\n- `workforce`: costs 5 credits per company and adds the `workforce` field to `CompanyInfo`.",
            "schema": {
              "type": "array",
              "items": {
                "enum": [
                  "workforce"
                ],
                "type": "string"
              }
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanySearchScrollInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CursorListWithMetadataOfCompanyInfoAndScrollMetadata"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/HttpValidationProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CityInfo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The ID of the city",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "The name of the city"
          },
          "latitude": {
            "type": "number",
            "description": "The latitude of the city",
            "format": "float",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "description": "The longitude of the city",
            "format": "float",
            "nullable": true
          }
        },
        "description": "The city information of the company",
        "nullable": true
      },
      "CompanyCategory": {
        "enum": [
          "b2b",
          "b2c",
          "b2g",
          "e-commerce",
          "media",
          "service-provider",
          "mobile",
          "saas"
        ]
      },
      "CompanyEmployees": {
        "enum": [
          "1-10",
          "11-50",
          "51-200",
          "201-500",
          "501-1K",
          "1K-5K",
          "5K-10K",
          "over-10K"
        ]
      },
      "CompanyExcludeFilters": {
        "type": "object",
        "properties": {
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The domain names of companies to exclude from the results",
            "nullable": true
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The region IDs to filter by",
            "nullable": true
          },
          "countries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The 2 letter country codes to filter by",
            "nullable": true
          },
          "states": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "The state IDs to filter by",
            "nullable": true
          },
          "cities": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "The city IDs to filter by",
            "nullable": true
          },
          "type": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyType"
            },
            "description": "The list of company types to filter by",
            "nullable": true
          },
          "category": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyCategory"
            },
            "description": "The list of company categories to filter by",
            "nullable": true
          },
          "employees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyEmployees"
            },
            "description": "The list of employee counts to filter by",
            "nullable": true
          },
          "reportedEmployees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyEmployees"
            },
            "description": "The list of externally reported employee counts to filter by",
            "nullable": true
          },
          "revenue": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyRevenue"
            },
            "description": "The list of revenue ranges to filter by",
            "nullable": true
          },
          "naicsCode": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included",
            "nullable": true
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The keywords to filter by",
            "nullable": true
          },
          "technologies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The technologies to filter by",
            "nullable": true
          },
          "fundingRounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyFundingRound"
            },
            "description": "The funding rounds to filter by",
            "nullable": true
          }
        },
        "description": "Exclusion filters to apply on the companies. If a company matches any of the filters here, it will be excluded from the results.",
        "nullable": true
      },
      "CompanyFinancialInfo": {
        "type": "object",
        "properties": {
          "stock_symbol": {
            "type": "string",
            "nullable": true
          },
          "stock_exchange": {
            "type": "string",
            "nullable": true
          },
          "total_funding": {
            "type": "integer",
            "format": "int64",
            "nullable": true
          },
          "funding_stage": {
            "type": "string",
            "nullable": true
          },
          "funding_date": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "funding": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyFundingInfo"
            },
            "nullable": true
          }
        },
        "description": "The financial information of the company",
        "nullable": true
      },
      "CompanyFundingAmountRange": {
        "type": "object",
        "properties": {
          "min": {
            "type": "number",
            "description": "The minimum funding amount (inclusive)",
            "format": "double",
            "nullable": true
          },
          "max": {
            "type": "number",
            "description": "The maximum funding amount (inclusive)",
            "format": "double",
            "nullable": true
          }
        },
        "description": "The funding amount range to filter by",
        "nullable": true
      },
      "CompanyFundingInfo": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "amount": {
            "type": "string",
            "nullable": true
          },
          "type": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true
          },
          "from": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "CompanyFundingRound": {
        "enum": [
          "seed",
          "debt_financing",
          "angel",
          "venture",
          "series_a",
          "series_b",
          "series_c",
          "series_d",
          "series_e",
          "series_f",
          "series_g",
          "series_h",
          "other"
        ]
      },
      "CompanyInfo": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The unique identifier of the company",
            "format": "uuid"
          },
          "name": {
            "maxLength": 1024,
            "type": "string",
            "description": "The name of the company",
            "nullable": true
          },
          "domain": {
            "maxLength": 1024,
            "type": "string",
            "description": "The primary domain name of the company",
            "nullable": true
          },
          "website": {
            "type": "string",
            "description": "The website URL of the company",
            "format": "uri",
            "nullable": true
          },
          "type": {
            "$ref": "#/components/schemas/NullableOfCompanyType"
          },
          "legalName": {
            "type": "string",
            "description": "The legal name of the company",
            "nullable": true
          },
          "industry": {
            "type": "string",
            "description": "The main industry of the company",
            "nullable": true
          },
          "industries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The industries associated with the company",
            "nullable": true
          },
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyCategory"
            },
            "description": "The categories of the company from most to least specific.",
            "nullable": true
          },
          "employees": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees"
          },
          "reported_employees": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees2"
          },
          "revenue": {
            "$ref": "#/components/schemas/NullableOfCompanyRevenue"
          },
          "description": {
            "type": "string",
            "description": "The description of the company",
            "nullable": true
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The search keywords of the company",
            "nullable": true
          },
          "technologies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The technologies associated with the company",
            "nullable": true
          },
          "subsidiaries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The subsidiaries associated with the company",
            "nullable": true
          },
          "founded_year": {
            "type": "integer",
            "description": "The year the company was founded",
            "format": "int32",
            "nullable": true
          },
          "naics_codes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The NAICS codes associated with the company",
            "nullable": true
          },
          "location": {
            "$ref": "#/components/schemas/CompanyLocationInfo"
          },
          "financial": {
            "$ref": "#/components/schemas/CompanyFinancialInfo"
          },
          "socials": {
            "$ref": "#/components/schemas/CompanySocialUrls"
          },
          "page_rank": {
            "type": "number",
            "description": "The page rank of the company",
            "format": "float",
            "nullable": true
          },
          "workforce": {
            "$ref": "#/components/schemas/CompanyWorkforceInfo"
          },
          "logo_url": {
            "type": "string",
            "description": "The logo URL of the company",
            "nullable": true
          },
          "seo_description": {
            "type": "string",
            "description": "The SEO description of the company",
            "nullable": true
          },
          "updated_at": {
            "type": "string",
            "description": "The last updated timestamp of the company",
            "format": "date-time"
          }
        }
      },
      "CompanyLocationInfo": {
        "type": "object",
        "properties": {
          "country": {
            "$ref": "#/components/schemas/CountryInfo"
          },
          "state": {
            "$ref": "#/components/schemas/StateInfo"
          },
          "city": {
            "$ref": "#/components/schemas/CityInfo"
          },
          "address": {
            "type": "string",
            "nullable": true
          },
          "postal_code": {
            "type": "string",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "nullable": true
          }
        },
        "description": "The location information of the company",
        "nullable": true
      },
      "CompanyRevenue": {
        "enum": [
          "under-1m",
          "1m-10m",
          "10m-50m",
          "50m-100m",
          "100m-200m",
          "200m-1b",
          "over-1b"
        ]
      },
      "CompanySearchScrollInput": {
        "type": "object",
        "properties": {
          "pageSize": {
            "maximum": 100,
            "minimum": 1,
            "type": "integer",
            "description": "The number of results to return in each page. Must be between 1 and 100",
            "format": "int32"
          },
          "cursor": {
            "maxLength": 1024,
            "type": "string",
            "description": "The cursor to use for pagination. This is used for cursor based pagination. If this is set, Page will be ignored.",
            "nullable": true
          },
          "lists": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The list IDs to filter by",
            "nullable": true
          },
          "semanticQuery": {
            "maxLength": 500,
            "type": "string",
            "description": "The semantic search query to find companies with. More natural language version of the standard query.",
            "nullable": true
          },
          "semanticWeight": {
            "maximum": 1,
            "minimum": 0,
            "type": "number",
            "description": "The semantic weight to apply to the results. Must be between 0 and 1. 0.7 is default. Larger values will prioritize semantic similarity, smaller values will prioritize traditional search factors.",
            "format": "double",
            "nullable": true
          },
          "exclude": {
            "$ref": "#/components/schemas/CompanyExcludeFilters"
          },
          "query": {
            "maxLength": 250,
            "type": "string",
            "description": "The search query to apply on the company name and domain",
            "nullable": true
          },
          "foundedYear": {
            "$ref": "#/components/schemas/YearRange"
          },
          "fundingAmount": {
            "$ref": "#/components/schemas/CompanyFundingAmountRange"
          },
          "fundingYear": {
            "$ref": "#/components/schemas/YearRange"
          },
          "categoryOperator": {
            "$ref": "#/components/schemas/NullableOfFilterOperator"
          },
          "keywordsOperator": {
            "$ref": "#/components/schemas/NullableOfFilterOperator"
          },
          "technologiesOperator": {
            "$ref": "#/components/schemas/NullableOfFilterOperator"
          },
          "workforceGrowth": {
            "$ref": "#/components/schemas/CompanyWorkforceGrowthInput"
          },
          "workforceSize": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyWorkforceSizeInput"
            },
            "description": "Filter companies by absolute workforce headcount. Multiple entries can be provided to filter on different departments simultaneously.",
            "nullable": true
          },
          "require": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FeatureRequirement"
            },
            "description": "The features that must exist for the company",
            "nullable": true
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The region IDs to filter by",
            "nullable": true
          },
          "countries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The 2 letter country codes to filter by",
            "nullable": true
          },
          "states": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "The state IDs to filter by",
            "nullable": true
          },
          "cities": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "The city IDs to filter by",
            "nullable": true
          },
          "type": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyType"
            },
            "description": "The list of company types to filter by",
            "nullable": true
          },
          "category": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyCategory"
            },
            "description": "The list of company categories to filter by",
            "nullable": true
          },
          "employees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyEmployees"
            },
            "description": "The list of employee counts to filter by",
            "nullable": true
          },
          "reportedEmployees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyEmployees"
            },
            "description": "The list of externally reported employee counts to filter by",
            "nullable": true
          },
          "revenue": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyRevenue"
            },
            "description": "The list of revenue ranges to filter by",
            "nullable": true
          },
          "naicsCode": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included",
            "nullable": true
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The keywords to filter by",
            "nullable": true
          },
          "technologies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The technologies to filter by",
            "nullable": true
          },
          "fundingRounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyFundingRound"
            },
            "description": "The funding rounds to filter by",
            "nullable": true
          }
        }
      },
      "CompanySocialUrls": {
        "type": "object",
        "properties": {
          "linkedin_url": {
            "type": "string",
            "description": "The LinkedIn URL of the company",
            "format": "uri",
            "nullable": true
          },
          "linkedin_id": {
            "maxLength": 1024,
            "type": "string",
            "description": "The LinkedIn ID of the company",
            "nullable": true
          },
          "twitter_url": {
            "type": "string",
            "description": "The Twitter URL of the company",
            "format": "uri",
            "nullable": true
          },
          "facebook_url": {
            "type": "string",
            "description": "The Facebook URL of the company",
            "format": "uri",
            "nullable": true
          },
          "instagram_url": {
            "type": "string",
            "description": "The Instagram URL of the company",
            "format": "uri",
            "nullable": true
          },
          "angellist_url": {
            "type": "string",
            "description": "The AngelList URL of the company",
            "format": "uri",
            "nullable": true
          },
          "crunchbase_url": {
            "type": "string",
            "description": "The Crunchbase URL of the company",
            "format": "uri",
            "nullable": true
          },
          "youtube_url": {
            "type": "string",
            "description": "The YouTube URL of the company",
            "format": "uri",
            "nullable": true
          },
          "github_url": {
            "type": "string",
            "description": "The GitHub URL of the company",
            "format": "uri",
            "nullable": true
          },
          "g2_url": {
            "type": "string",
            "description": "The G2 URL of the company",
            "format": "uri",
            "nullable": true
          }
        },
        "description": "The social URLs of the company"
      },
      "CompanyType": {
        "enum": [
          "private",
          "public",
          "self-employed",
          "self-owned",
          "partnership",
          "nonprofit",
          "educational",
          "government"
        ]
      },
      "CompanyWorkforceDepartmentHeadcount": {
        "type": "object",
        "properties": {
          "c_suite": {
            "type": "integer",
            "description": "Headcount in the c-suite root department.",
            "format": "int32",
            "nullable": true
          },
          "product_management": {
            "type": "integer",
            "description": "Headcount in the product management root department.",
            "format": "int32",
            "nullable": true
          },
          "engineering_technical": {
            "type": "integer",
            "description": "Headcount in the engineering and technical root department.",
            "format": "int32",
            "nullable": true
          },
          "design": {
            "type": "integer",
            "description": "Headcount in the design root department.",
            "format": "int32",
            "nullable": true
          },
          "education": {
            "type": "integer",
            "description": "Headcount in the education root department.",
            "format": "int32",
            "nullable": true
          },
          "finance": {
            "type": "integer",
            "description": "Headcount in the finance root department.",
            "format": "int32",
            "nullable": true
          },
          "human_resources": {
            "type": "integer",
            "description": "Headcount in the human resources root department.",
            "format": "int32",
            "nullable": true
          },
          "information_technology": {
            "type": "integer",
            "description": "Headcount in the information technology root department.",
            "format": "int32",
            "nullable": true
          },
          "legal": {
            "type": "integer",
            "description": "Headcount in the legal root department.",
            "format": "int32",
            "nullable": true
          },
          "marketing": {
            "type": "integer",
            "description": "Headcount in the marketing root department.",
            "format": "int32",
            "nullable": true
          },
          "medical_health": {
            "type": "integer",
            "description": "Headcount in the medical and health root department.",
            "format": "int32",
            "nullable": true
          },
          "operations": {
            "type": "integer",
            "description": "Headcount in the operations root department.",
            "format": "int32",
            "nullable": true
          },
          "sales": {
            "type": "integer",
            "description": "Headcount in the sales root department.",
            "format": "int32",
            "nullable": true
          },
          "consulting": {
            "type": "integer",
            "description": "Headcount in the consulting root department.",
            "format": "int32",
            "nullable": true
          }
        },
        "description": "Headcount grouped by root department name."
      },
      "CompanyWorkforceGrowthInput": {
        "type": "object",
        "properties": {
          "period": {
            "$ref": "#/components/schemas/NullableOfCompanyWorkforceGrowthPeriod"
          },
          "department": {
            "$ref": "#/components/schemas/NullableOfCompanyWorkforceGrowthDepartment"
          },
          "minPercent": {
            "type": "number",
            "description": "The minimum workforce growth percentage (inclusive). Example: 15 means 15% growth, -10 means 10% decline.",
            "format": "double",
            "nullable": true
          },
          "maxPercent": {
            "type": "number",
            "description": "The maximum workforce growth percentage (inclusive). Example: 15 means 15% growth, -10 means 10% decline.",
            "format": "double",
            "nullable": true
          }
        },
        "description": "Filter companies by workforce growth percentage over a selected period and department.",
        "nullable": true
      },
      "CompanyWorkforceHistoryEntry": {
        "required": [
          "date",
          "department_headcount"
        ],
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "First day of the month for this snapshot.",
            "format": "date"
          },
          "observed_employee_count": {
            "type": "integer",
            "description": "Observed number of distinct employees in our people dataset for this month.",
            "format": "int32"
          },
          "employee_count_range": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees"
          },
          "department_headcount": {
            "$ref": "#/components/schemas/CompanyWorkforceDepartmentHeadcount"
          },
          "unclassified_headcount": {
            "type": "integer",
            "description": "Headcount where department could not be classified.",
            "format": "int32"
          }
        }
      },
      "CompanyWorkforceInfo": {
        "required": [
          "company_id",
          "domain",
          "department_headcount"
        ],
        "type": "object",
        "properties": {
          "company_id": {
            "type": "string",
            "description": "The CompanyEnrich ID of the company.",
            "format": "uuid"
          },
          "domain": {
            "type": "string",
            "description": "The canonical domain of the company."
          },
          "observed_employee_count": {
            "type": "integer",
            "description": "Observed number of distinct current employees in our people dataset.",
            "format": "int32"
          },
          "employee_count_range": {
            "$ref": "#/components/schemas/NullableOfCompanyEmployees"
          },
          "department_headcount": {
            "$ref": "#/components/schemas/CompanyWorkforceDepartmentHeadcount"
          },
          "unclassified_headcount": {
            "type": "integer",
            "description": "Headcount where department could not be classified.",
            "format": "int32"
          },
          "history": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyWorkforceHistoryEntry"
            },
            "description": "Monthly workforce snapshots showing headcount changes over time. Only months where headcount changed are included.",
            "nullable": true
          }
        },
        "description": "Expanded workforce insights for the company. This field is only returned when `expand=workforce` is requested.",
        "nullable": true
      },
      "CompanyWorkforceSizeInput": {
        "type": "object",
        "properties": {
          "department": {
            "$ref": "#/components/schemas/NullableOfCompanyWorkforceGrowthDepartment2"
          },
          "min": {
            "type": "integer",
            "description": "The minimum headcount (inclusive).",
            "format": "int32",
            "nullable": true
          },
          "max": {
            "type": "integer",
            "description": "The maximum headcount (inclusive).",
            "format": "int32",
            "nullable": true
          }
        }
      },
      "CountryInfo": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The ISO 3166-1 alpha-2 code of the country"
          },
          "name": {
            "type": "string",
            "description": "The name of the country"
          },
          "latitude": {
            "type": "number",
            "description": "The latitude of the country",
            "format": "float",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "description": "The longitude of the country",
            "format": "float",
            "nullable": true
          }
        },
        "description": "The origin country information of the company",
        "nullable": true
      },
      "CursorListWithMetadataOfCompanyInfoAndScrollMetadata": {
        "required": [
          "items"
        ],
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyInfo"
            },
            "description": "The items in the list"
          },
          "metadata": {
            "$ref": "#/components/schemas/ScrollMetadata"
          },
          "nextCursor": {
            "type": "string",
            "description": "The cursor for the next page",
            "nullable": true
          },
          "previousCursor": {
            "type": "string",
            "description": "The cursor for the previous page",
            "nullable": true
          },
          "totalItems": {
            "type": "integer",
            "description": "The total number of items in the list",
            "format": "int32"
          },
          "startIndex": {
            "type": "integer",
            "description": "The index of the first item in the entire result set",
            "format": "int32",
            "nullable": true
          }
        }
      },
      "FeatureRequirement": {
        "enum": [
          "linkedin",
          "twitter",
          "facebook",
          "instagram",
          "angellist",
          "crunchbase",
          "youtube",
          "country",
          "city",
          "state",
          "revenue",
          "foundedYear",
          "anyFunding"
        ]
      },
      "HttpValidationProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          },
          "errors": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      },
      "NullableOfCompanyEmployees": {
        "enum": [
          "1-10",
          "11-50",
          "51-200",
          "201-500",
          "501-1K",
          "1K-5K",
          "5K-10K",
          "over-10K",
          null
        ],
        "description": "The employee count range.",
        "nullable": true
      },
      "NullableOfCompanyEmployees2": {
        "enum": [
          "1-10",
          "11-50",
          "51-200",
          "201-500",
          "501-1K",
          "1K-5K",
          "5K-10K",
          "over-10K",
          null
        ],
        "description": "The employee count range reported by external data providers.",
        "nullable": true
      },
      "NullableOfCompanyRevenue": {
        "enum": [
          "under-1m",
          "1m-10m",
          "10m-50m",
          "50m-100m",
          "100m-200m",
          "200m-1b",
          "over-1b",
          null
        ],
        "description": "The range of annual revenue of the company in USD",
        "nullable": true
      },
      "NullableOfCompanyType": {
        "enum": [
          "unknown",
          "private",
          "public",
          "self-employed",
          "self-owned",
          "partnership",
          "nonprofit",
          "educational",
          "government",
          null
        ],
        "description": "The type of the company",
        "nullable": true
      },
      "NullableOfCompanyWorkforceGrowthDepartment": {
        "enum": [
          "overall",
          "c_suite",
          "product_management",
          "engineering_technical",
          "design",
          "education",
          "finance",
          "human_resources",
          "information_technology",
          "legal",
          "marketing",
          "medical_health",
          "operations",
          "sales",
          "consulting",
          null
        ],
        "description": "The department to measure workforce growth for.",
        "nullable": true
      },
      "NullableOfCompanyWorkforceGrowthDepartment2": {
        "enum": [
          "overall",
          "c_suite",
          "product_management",
          "engineering_technical",
          "design",
          "education",
          "finance",
          "human_resources",
          "information_technology",
          "legal",
          "marketing",
          "medical_health",
          "operations",
          "sales",
          "consulting",
          null
        ],
        "description": "The department to filter headcount for. Defaults to overall if not specified.",
        "nullable": true
      },
      "NullableOfCompanyWorkforceGrowthPeriod": {
        "enum": [
          "m6",
          "y1",
          "y2",
          null
        ],
        "description": "The period to measure workforce growth over.",
        "nullable": true
      },
      "NullableOfFilterOperator": {
        "enum": [
          "And",
          "Or",
          null
        ],
        "description": "The operator to apply to the filters. Defaults to And.",
        "nullable": true
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "ScrollMetadata": {
        "type": "object",
        "properties": {
          "totalMatching": {
            "type": "integer",
            "description": "The total number of companies matching the search query, disregarding any pagination limits. This is greater or equal to totalItems, which is the actual number of items that can be paginated.",
            "format": "int32"
          }
        },
        "description": "The additional metadata for the list",
        "nullable": true
      },
      "StateInfo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The ID of the state",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "The name of the state"
          },
          "code": {
            "type": "string",
            "description": "The ISO 3166-2 code of the state",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "description": "The latitude of the state",
            "format": "float",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "description": "The longitude of the state",
            "format": "float",
            "nullable": true
          }
        },
        "description": "The state information of the company",
        "nullable": true
      },
      "YearRange": {
        "type": "object",
        "properties": {
          "min": {
            "type": "integer",
            "description": "The minimum year (inclusive)",
            "format": "int32",
            "nullable": true
          },
          "max": {
            "type": "integer",
            "description": "The maximum year (inclusive)",
            "format": "int32",
            "nullable": true
          }
        },
        "description": "The range of years",
        "nullable": true
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "description": "API Token used for authentication. Example: \"Authorization: Bearer {token}\"",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "tags": [
    {
      "name": "Company / Search",
      "description": "Search companies by filters with pagination and cursor scrolling."
    }
  ]
}
````