---
updatedAt: 2026-07-27T17:15:20.000Z
agentTools:
  projectIndex: https://developer.demandbase.com/llms.txt
---

# Search companies

Use this endpoint to search for companies based on a variety of attributes.

You can search companies by name, website, ticker, location (city, state, country, ZIP), industry classification (NAICS, SIC), or attributes like fiscal year end, business structure, and fortune ranking. 

Additional filters let you set employee or revenue ranges, include only primary industry or SIC classifications, and apply diversity criteria (e.g., minority-owned or women-owned businesses). 

Sorting and pagination are supported. You can sort results by fields such as `companyRevenue` and more, and control the number of results returned using `page` and `perPage`.

# OpenAPI definition

````json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "title": "B2B API",
    "description": "The B2B API provides access to endpoints for searching, retrieving, and matching company and contact data.\n\nIt includes support for:\n- **Company records:** Firmographic details, news, technologies, and more.\n- **Contact records:** Current role, employment history, and professional details.\n- **Demandbase Person profiles:** Persistent identities tied to individuals across multiple roles or companies.\n- **Subscriptions:** Monitoring updates to companies and DB Person records.\n## Authentication\nAll requests to the B2B API must be authenticated using a valid API token. If authentication fails, the API will respond with a `401 Unauthorized` status code.\n### Obtaining an API Token\nFor instructions on generating API tokens, see the [Generate and Manage API Key Set](https://support.demandbase.com/hc/en-us/articles/38999526296603-Generate-and-Manage-API-Key-Set) article at the Demandbase Help Center.\n### Authorization Header\nInclude your API token in the `Authorization` header of each request using the Bearer token scheme. Also set the `Content-Type` header to `application/json` when sending JSON payloads.\n#### Example\n```\nAuthorization: Bearer YOUR_API_KEY_HERE\nContent-Type: application/json\n```\n\n> **Note:** Tokens should be treated as sensitive credentials. Do not expose them in public code repositories or client-side applications.",
    "contact": {
      "name": "Support",
      "url": "https://www.demandbase.com/",
      "email": "support@demandbase.com"
    }
  },
  "servers": [
    {
      "url": "https://uapi.demandbase.com/data/b2b/v1",
      "description": "Server URL in Production environment"
    }
  ],
  "paths": {
    "/companies": {
      "post": {
        "tags": [
          "Sync API"
        ],
        "summary": "Search companies",
        "description": "Use this endpoint to search for companies based on a variety of attributes.\n\nYou can search companies by name, website, ticker, location (city, state, country, ZIP), industry classification (NAICS, SIC), or attributes like fiscal year end, business structure, and fortune ranking. \n\nAdditional filters let you set employee or revenue ranges, include only primary industry or SIC classifications, and apply diversity criteria (e.g., minority-owned or women-owned businesses). \n\nSorting and pagination are supported. You can sort results by fields such as `companyRevenue` and more, and control the number of results returned using `page` and `perPage`.",
        "operationId": "companySearch_1",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanySearchRequestDTO"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/CompanySearchRequestDTO"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful operation or No companies found for query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanySearchResponseDTO"
                },
                "examples": {
                  "SuccessResponse": {
                    "description": "SuccessResponse",
                    "value": {
                      "companies": [
                        {
                          "name": "Northgate Logistics LLC",
                          "city": "New Plymouth",
                          "state": "ID",
                          "country": "US",
                          "companyId": 406321
                        },
                        {
                          "name": "Blue Ridge Transport Inc.",
                          "city": "Walcott",
                          "state": "IA",
                          "country": "US",
                          "companyId": 1013683
                        },
                        {
                          "name": "Horizon Freight Services",
                          "city": "North Baltimore",
                          "state": "OH",
                          "country": "US",
                          "companyId": 8664201
                        },
                        {
                          "name": "Summit Distribution Co.",
                          "city": "Johnstown",
                          "state": "CO",
                          "country": "US",
                          "companyId": 9557195
                        },
                        {
                          "name": "Granite Commerce Group",
                          "city": "New Plymouth",
                          "state": "ID",
                          "country": "US",
                          "companyId": 284576424
                        },
                        {
                          "name": "Lakeside Operations LLC",
                          "city": "Oak Grove",
                          "state": "MO",
                          "country": "US",
                          "companyId": 8679793
                        },
                        {
                          "name": "Pioneer Mobility Partners",
                          "city": "Mineral Wells",
                          "state": "WV",
                          "country": "US",
                          "companyId": 6242601
                        },
                        {
                          "name": "Meridian Media Group",
                          "city": "New York",
                          "state": "NY",
                          "country": "US",
                          "companyId": 8108950
                        },
                        {
                          "name": "Redwood Industrial Supply",
                          "city": "Pine Bluffs",
                          "state": "WY",
                          "country": "US",
                          "companyId": 5914035
                        },
                        {
                          "name": "Willow Creek Services",
                          "city": "Calhoun City",
                          "state": "MS",
                          "country": "US",
                          "companyId": 6632012
                        }
                      ],
                      "totalCount": 165,
                      "pageNo": 1,
                      "pageSize": 10
                    }
                  },
                  "EmptyCompaniesResponse": {
                    "description": "EmptyCompaniesResponse",
                    "value": {
                      "companies": [],
                      "totalCount": 0,
                      "pageNo": 1,
                      "pageSize": 10
                    }
                  }
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/CompanySearchResponseDTO"
                },
                "examples": {
                  "SuccessResponseXml": {
                    "description": "SuccessResponseXml",
                    "value": {
                      "companies": [
                        {
                          "name": "Northgate Logistics LLC",
                          "city": "New Plymouth",
                          "state": "ID",
                          "country": "US",
                          "companyId": 406321
                        },
                        {
                          "name": "Blue Ridge Transport Inc.",
                          "city": "Walcott",
                          "state": "IA",
                          "country": "US",
                          "companyId": 1013683
                        }
                      ],
                      "totalCount": 165,
                      "pageNo": 1,
                      "pageSize": 10
                    }
                  },
                  "EmptyCompaniesResponseXml": {
                    "description": "EmptyCompaniesResponseXml",
                    "value": {
                      "companies": [],
                      "totalCount": 0,
                      "pageNo": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "BadRequestResponse": {
                    "description": "BadRequestResponse",
                    "value": {
                      "errorCode": "400-102",
                      "errorMessage": "At least one parameter must be provided for company search.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "ResultsPerPageErrorResponse": {
                    "description": "ResultsPerPageErrorResponse",
                    "value": {
                      "errorCode": "400-101",
                      "errorMessage": "perPage must be between 1 and 50.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "PageNumberErrorResponse": {
                    "description": "PageNumberErrorResponse",
                    "value": {
                      "errorCode": "400-100",
                      "errorMessage": "page number must be greater than or equal to 1.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidSortByParam": {
                    "description": "InvalidSortByParam",
                    "value": {
                      "errorCode": "400-135",
                      "errorMessage": "Sorting is allowed only on employeeCount, businessType, companyRevenue and location",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidSortOrder": {
                    "description": "InvalidSortOrder",
                    "value": {
                      "errorCode": "400-109",
                      "errorMessage": "Sorting order can be either asc or desc.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidCompanyCountryId": {
                    "description": "InvalidCompanyCountryId",
                    "value": {
                      "errorCode": "400-214",
                      "errorMessage": "Invalid country. Please enter valid country ID in country.",
                      "diagnosticCode": "2ec12de8-1000-4620-8757-6091a1cffab7"
                    }
                  },
                  "InvalidNewsCategories": {
                    "description": "InvalidNewsCategories",
                    "value": {
                      "errorCode": "400-112",
                      "errorMessage": "Invalid newsCategories. Valid values are: leadership Changes, new Offerings, acquisitions, partnerships, expanding operations, cost cutting, outperforming, underperforming, company presentation, litigation, compliance, research and development, data security, funding developments, bankruptcy and restructuring, real estate: deals, real estate: construction, corporate challenges",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidNewsDuration": {
                    "description": "InvalidNewsDuration",
                    "value": {
                      "errorCode": "400-113",
                      "errorMessage": "Invalid newsDuration. Valid values are between 1 and 30",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidIndustry": {
                    "description": "InvalidIndustry",
                    "value": {
                      "errorCode": "400-114",
                      "errorMessage": "Industry Id must be an integer.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidMaxEmployees": {
                    "description": "InvalidMaxEmployees",
                    "value": {
                      "errorCode": "400-121",
                      "errorMessage": "maxEmployees must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidMinEmployees": {
                    "description": "InvalidMinEmployees",
                    "value": {
                      "errorCode": "400-120",
                      "errorMessage": "minEmployees must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidMaxRevenue": {
                    "description": "InvalidMaxRevenue",
                    "value": {
                      "errorCode": "400-119",
                      "errorMessage": "maxRevenue must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidMinRevenue": {
                    "description": "InvalidMinRevenue",
                    "value": {
                      "errorCode": "400-118",
                      "errorMessage": "minRevenue must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidBusinessStructure": {
                    "description": "InvalidBusinessStructure",
                    "value": {
                      "errorCode": "400-128",
                      "errorMessage": "Invalid businessStructure. Valid values are: uncategorized, globalParent, subsidiary, group, branch, independent",
                      "diagnosticCode": "cebdea29-25ac-40e5-af41-0626e34e6f46"
                    }
                  },
                  "InvalidBusinessType": {
                    "description": "InvalidBusinessType",
                    "value": {
                      "errorCode": "400-129",
                      "errorMessage": "Invalid businessType. Valid values are: public, private, school, government, organization",
                      "diagnosticCode": "2b7cd799-e532-46a4-bc4e-e967b0a40f4b"
                    }
                  },
                  "InvalidCompanyStatus": {
                    "description": "InvalidCompanyStatus",
                    "value": {
                      "errorCode": "400-130",
                      "errorMessage": "Invalid companyStatus. Valid values are: unassigned, operating, non-operating, acquired, liquidating, outOfBusiness",
                      "diagnosticCode": "bb841d37-ed8f-4a82-a5c5-fd11ea6d8e3d"
                    }
                  },
                  "InvalidFiscalYearEnd": {
                    "description": "InvalidFiscalYearEnd",
                    "value": {
                      "errorCode": "400-131",
                      "errorMessage": "Invalid fiscalYearEnd. fiscalYearEnd should be a valid month name.",
                      "diagnosticCode": "67521433-a92b-49ee-9d21-21d4007f8486"
                    }
                  },
                  "InvalidFortuneRanking": {
                    "description": "InvalidFortuneRanking",
                    "value": {
                      "errorCode": "400-132",
                      "errorMessage": "Invalid fortuneRanking. Valid values are: fortune500, fortune1000",
                      "diagnosticCode": "1921c127-a8e6-4685-aaa0-1f6bce967a18"
                    }
                  },
                  "InvalidEmployeeRange": {
                    "description": "InvalidEmployeeRange",
                    "value": {
                      "errorCode": "400-126",
                      "errorMessage": "minEmployees must be less than or equal to maxEmployees.",
                      "diagnosticCode": "ddda8332-696c-4e74-897b-f5cc5525ddbe"
                    }
                  },
                  "InvalidRevenueRange": {
                    "description": "InvalidRevenueRange",
                    "value": {
                      "errorCode": "400-127",
                      "errorMessage": "minRevenue must be less than or equal to minRevenue.",
                      "diagnosticCode": "cbc2bbd0-a801-41c1-a546-be6ea0e75797"
                    }
                  },
                  "InvalidRegions": {
                    "description": "InvalidRegions",
                    "value": {
                      "errorCode": "400-133",
                      "errorMessage": "Invalid region. Valid values are: Africa, Asia, Europe, MiddleEast, NorthAmerica, Oceania, SouthAmerica",
                      "diagnosticCode": "88d76e2d-6f09-4018-97fe-b41c64f5ac67"
                    }
                  },
                  "InvalidCompanyType": {
                    "description": "InvalidCompanyType",
                    "value": {
                      "errorCode": "400-134",
                      "errorMessage": "Invalid companyType. Valid values are: unknown, public, private, government, organization",
                      "diagnosticCode": "ed1cfeb5-a7bf-4621-a4f3-51b1e8f106ae"
                    }
                  },
                  "InvalidGender": {
                    "description": "InvalidGender",
                    "value": {
                      "errorCode": "400-117",
                      "errorMessage": "Invalid gender. Valid values are male and female",
                      "diagnosticCode": "fa7db512-d0ef-4c9d-aa8b-6e6bc21a61bc"
                    }
                  },
                  "InvalidEthnicity": {
                    "description": "InvalidEthnicity",
                    "value": {
                      "errorCode": "400-136",
                      "errorMessage": "Invalid Ethnicity Ids. Ethnicity Ids should be between 1 and 7",
                      "diagnosticCode": "126df328-b3d1-4d62-9464-e435aa706805"
                    }
                  }
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "BadRequestResponseXml": {
                    "description": "BadRequestResponseXml",
                    "value": {
                      "errorCode": "400-102",
                      "errorMessage": "At least one parameter must be provided for company search.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "ResultsPerPageErrorResponseXml": {
                    "description": "ResultsPerPageErrorResponseXml",
                    "value": {
                      "errorCode": "400-101",
                      "errorMessage": "perPage must be between 1 and 50.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "PageNumberErrorResponseXml": {
                    "description": "PageNumberErrorResponseXml",
                    "value": {
                      "errorCode": "400-100",
                      "errorMessage": "page number must be greater than or equal to 1.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidSortByParam": {
                    "description": "InvalidSortByParam",
                    "value": {
                      "errorCode": "400-135",
                      "errorMessage": "Sorting is allowed only on employeeCount, businessType, companyRevenue and location",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidSortOrder": {
                    "description": "InvalidSortOrder",
                    "value": {
                      "errorCode": "400-109",
                      "errorMessage": "Sorting order can be either asc or desc.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidCompanyCountryId": {
                    "description": "InvalidCompanyCountryId",
                    "value": {
                      "errorCode": "400-214",
                      "errorMessage": "Invalid country. Please enter valid country ID in country.",
                      "diagnosticCode": "2ec12de8-1000-4620-8757-6091a1cffab7"
                    }
                  },
                  "InvalidNewsCategories": {
                    "description": "InvalidNewsCategories",
                    "value": {
                      "errorCode": "400-112",
                      "errorMessage": "Invalid newsCategories. Valid values are: leadership Changes, new Offerings, acquisitions, partnerships, expanding operations, cost cutting, outperforming, underperforming, company presentation, litigation, compliance, research and development, data security, funding developments, bankruptcy and restructuring, real estate: deals, real estate: construction, corporate challenges",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidNewsDuration": {
                    "description": "InvalidNewsDuration",
                    "value": {
                      "errorCode": "400-113",
                      "errorMessage": "Invalid newsDuration. Valid values are between 1 and 30",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidIndustry": {
                    "description": "InvalidIndustry",
                    "value": {
                      "errorCode": "400-114",
                      "errorMessage": "Industry Id must be an integer.",
                      "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
                    }
                  },
                  "InvalidMaxEmployees": {
                    "description": "InvalidMaxEmployees",
                    "value": {
                      "errorCode": "400-121",
                      "errorMessage": "maxEmployees must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidMinEmployees": {
                    "description": "InvalidMinEmployees",
                    "value": {
                      "errorCode": "400-120",
                      "errorMessage": "minEmployees must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidMaxRevenue": {
                    "description": "InvalidMaxRevenue",
                    "value": {
                      "errorCode": "400-119",
                      "errorMessage": "maxRevenue must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidMinRevenue": {
                    "description": "InvalidMinRevenue",
                    "value": {
                      "errorCode": "400-118",
                      "errorMessage": "minRevenue must be greater than or equal to 0.",
                      "diagnosticCode": "88ea1636-3c9d-40ec-bdc4-e28d8ec1d069"
                    }
                  },
                  "InvalidBusinessStructure": {
                    "description": "InvalidBusinessStructure",
                    "value": {
                      "errorCode": "400-128",
                      "errorMessage": "Invalid businessStructure. Valid values are: uncategorized, globalParent, subsidiary, group, branch, independent",
                      "diagnosticCode": "cebdea29-25ac-40e5-af41-0626e34e6f46"
                    }
                  },
                  "InvalidBusinessType": {
                    "description": "InvalidBusinessType",
                    "value": {
                      "errorCode": "400-129",
                      "errorMessage": "Invalid businessType. Valid values are: public, private, school, government, organization",
                      "diagnosticCode": "2b7cd799-e532-46a4-bc4e-e967b0a40f4b"
                    }
                  },
                  "InvalidCompanyStatus": {
                    "description": "InvalidCompanyStatus",
                    "value": {
                      "errorCode": "400-130",
                      "errorMessage": "Invalid companyStatus. Valid values are: unassigned, operating, non-operating, acquired, liquidating, outOfBusiness",
                      "diagnosticCode": "bb841d37-ed8f-4a82-a5c5-fd11ea6d8e3d"
                    }
                  },
                  "InvalidFiscalYearEnd": {
                    "description": "InvalidFiscalYearEnd",
                    "value": {
                      "errorCode": "400-131",
                      "errorMessage": "Invalid fiscalYearEnd. fiscalYearEnd should be a valid month name.",
                      "diagnosticCode": "67521433-a92b-49ee-9d21-21d4007f8486"
                    }
                  },
                  "InvalidFortuneRanking": {
                    "description": "InvalidFortuneRanking",
                    "value": {
                      "errorCode": "400-132",
                      "errorMessage": "Invalid fortuneRanking. Valid values are: fortune500, fortune1000",
                      "diagnosticCode": "1921c127-a8e6-4685-aaa0-1f6bce967a18"
                    }
                  },
                  "InvalidEmployeeRange": {
                    "description": "InvalidEmployeeRange",
                    "value": {
                      "errorCode": "400-126",
                      "errorMessage": "minEmployees must be less than or equal to maxEmployees.",
                      "diagnosticCode": "ddda8332-696c-4e74-897b-f5cc5525ddbe"
                    }
                  },
                  "InvalidRevenueRange": {
                    "description": "InvalidRevenueRange",
                    "value": {
                      "errorCode": "400-127",
                      "errorMessage": "minRevenue must be less than or equal to minRevenue.",
                      "diagnosticCode": "cbc2bbd0-a801-41c1-a546-be6ea0e75797"
                    }
                  },
                  "InvalidRegions": {
                    "description": "InvalidRegions",
                    "value": {
                      "errorCode": "400-133",
                      "errorMessage": "Invalid region. Valid values are: Africa, Asia, Europe, MiddleEast, NorthAmerica, Oceania, SouthAmerica",
                      "diagnosticCode": "88d76e2d-6f09-4018-97fe-b41c64f5ac67"
                    }
                  },
                  "InvalidCompanyType": {
                    "description": "InvalidCompanyType",
                    "value": {
                      "errorCode": "400-134",
                      "errorMessage": "Invalid companyType. Valid values are: unknown, public, private, government, organization",
                      "diagnosticCode": "ed1cfeb5-a7bf-4621-a4f3-51b1e8f106ae"
                    }
                  },
                  "InvalidGender": {
                    "description": "InvalidGender",
                    "value": {
                      "errorCode": "400-117",
                      "errorMessage": "Invalid gender. Valid values are male and female",
                      "diagnosticCode": "fa7db512-d0ef-4c9d-aa8b-6e6bc21a61bc"
                    }
                  },
                  "InvalidEthnicity": {
                    "description": "InvalidEthnicity",
                    "value": {
                      "errorCode": "400-136",
                      "errorMessage": "Invalid Ethnicity Ids. Ethnicity Ids should be between 1 and 7",
                      "diagnosticCode": "126df328-b3d1-4d62-9464-e435aa706805"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized because the user is not authenticated.",
            "content": {
              "application/json": {
                "examples": {
                  "UnauthorizedResponse": {
                    "description": "UnauthorizedResponse",
                    "value": {
                      "status": "Authentication Failed - Unauthorized."
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "servers": [
          {
            "url": "https://uapi.demandbase.com/data/b2b/v1",
            "description": "Server URL in Production environment"
          }
        ]
      }
    }
  },
  "tags": [
    {
      "name": "Sync API",
      "description": "Synchronous company, contact, matching, news, and logo operations."
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "description": "[<span style=\"text-decoration:underline;color:blue; font-size:1.25em\">How To Generate Bearer Tokens</span>](https://developer.demandbase.com/docs/auth-api)",
        "scheme": "bearer"
      }
    },
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string"
          },
          "errorMessage": {
            "type": "string"
          },
          "diagnosticCode": {
            "type": "string"
          }
        },
        "xml": {
          "name": "error"
        }
      },
      "CompanySearchRequestDTO": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "Demandbase"
          },
          "website": {
            "type": "string",
            "example": "demandbase.com"
          },
          "ticker": {
            "type": "string",
            "example": "MSFT"
          },
          "state": {
            "type": "string",
            "example": "CA"
          },
          "areaCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "415",
              "628"
            ]
          },
          "cities": {
            "type": "string",
            "example": "San Francisco,New York"
          },
          "businessTypes": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "public",
                "private",
                "school",
                "government",
                "organization"
              ]
            },
            "example": [
              "public",
              "private"
            ]
          },
          "country": {
            "type": "string",
            "description": "Country Id",
            "example": "1"
          },
          "companyStatus": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "unassigned",
                "operating",
                "non-operating",
                "acquired",
                "liquidating",
                "outOfBusiness"
              ]
            },
            "example": [
              "unassigned",
              "operating"
            ]
          },
          "fiscalYearEnd": {
            "type": "string",
            "example": "january"
          },
          "fortuneRanking": {
            "type": "string",
            "enum": [
              "fortune500",
              "fortune1000"
            ],
            "example": "fortune500"
          },
          "industries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "1",
              "2"
            ]
          },
          "subIndustries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "1_1",
              "2_1"
            ]
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "keyword1",
              "keyword2"
            ]
          },
          "minEmployees": {
            "type": "string",
            "example": "10"
          },
          "maxEmployees": {
            "type": "string",
            "example": "1000"
          },
          "minRevenue": {
            "type": "string",
            "description": "Minimum annual revenue in millions.",
            "example": "1"
          },
          "maxRevenue": {
            "type": "string",
            "description": "Maximum annual revenue in millions.",
            "example": "50"
          },
          "naics": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "511210",
              "5415*"
            ]
          },
          "sicCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "7375",
              "5678"
            ]
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "asia",
                "africa",
                "europe",
                "middleeast",
                "northamerica",
                "oceania",
                "southamerica"
              ]
            },
            "example": [
              "asia",
              "africa"
            ]
          },
          "street": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "123 Main St",
              "456 Elm St"
            ]
          },
          "companyType": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "public",
                "private",
                "government",
                "organization"
              ]
            },
            "example": [
              "public",
              "private"
            ]
          },
          "businessStructure": {
            "type": "string",
            "enum": [
              "uncategorized",
              "globalParent",
              "subsidiary",
              "group",
              "branch",
              "independent"
            ],
            "example": "globalParent"
          },
          "zipCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "500001",
              "500002"
            ]
          },
          "sortBy": {
            "type": "string",
            "example": "companyRevenue"
          },
          "sortOrder": {
            "type": "string",
            "enum": [
              "asc",
              "desc"
            ],
            "example": "asc"
          },
          "primaryIndustryOnly": {
            "type": "string",
            "default": "false"
          },
          "primarySICOnly": {
            "type": "string",
            "default": "false"
          },
          "gender": {
            "type": "string",
            "enum": [
              "male",
              "female"
            ],
            "example": "male"
          },
          "ethnicity": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7"
              ]
            },
            "example": [
              "1",
              "2"
            ]
          },
          "wbe": {
            "type": "string",
            "example": "true"
          },
          "vbe": {
            "type": "string",
            "example": "true"
          },
          "dbe": {
            "type": "string",
            "example": "true"
          },
          "mbe": {
            "type": "string",
            "example": "true"
          },
          "lgbt": {
            "type": "string",
            "example": "true"
          },
          "disabled": {
            "type": "string",
            "example": "true"
          },
          "companyIdsToExclude": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "726263",
              "726256"
            ]
          },
          "page": {
            "type": "string",
            "example": "1"
          },
          "perPage": {
            "type": "string",
            "example": "10"
          }
        }
      },
      "CompanySearchResponseDTO": {
        "type": "object",
        "properties": {
          "companies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyDTO"
            },
            "xml": {
              "name": "company"
            }
          },
          "totalCount": {
            "type": "integer",
            "format": "int64"
          },
          "pageNo": {
            "type": "integer",
            "format": "int64"
          },
          "pageSize": {
            "type": "integer",
            "format": "int64"
          }
        },
        "xml": {
          "name": "companies"
        }
      },
      "CompanyDTO": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "companyId": {
            "type": "integer",
            "format": "int32"
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
````