---
updatedAt: 2025-06-02T07:56:27.000Z
agentTools:
  projectIndex: https://docs.beauhurst.com/llms.txt
---

# Search for companies

Search by name, website, Companies House ID, Beauhurst ID  or Collection ID to find companies

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Beauhurst API",
    "description": "<h3>Usage</h3><p>The API only accepts <code>GET</code> requests over HTTPS.</p><h3>Authorization</h3><p>The Beauhurst API requires authentication in the form of an API key. To obtain an API key, please contact your subscription's account manager at Beauhurst. Be sure to keep this key <strong>private</strong> and <strong>secure</strong>.</p>",
    "version": "beauhurstapi"
  },
  "security": [
    {
      "ApiKey": []
    }
  ],
  "paths": {
    "/v1/companies/search": {
      "get": {
        "operationId": "v1_companies_search",
        "summary": "Search for companies by Companies House ID, name or collection ID",
        "description": "Takes an array of Companies House IDs or names, or a collection ID. Returns paginated data on these companies",
        "parameters": [
          {
            "name": "sort",
            "in": "query",
            "description": "Which field to use when ordering the results.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results to return per page.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The initial index from which to return the results.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "collection_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 6,
              "maxLength": 6
            }
          },
          {
            "name": "modified_since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "added_to_collection_since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "companies_house_ids",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^[A-Z0-9]{8}$",
                "minLength": 1
              }
            }
          },
          {
            "name": "names",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            }
          },
          {
            "name": "company_ids",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 8,
                "minLength": 6
              }
            }
          },
          {
            "name": "websites",
            "in": "query",
            "required": false,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            }
          },
          {
            "name": "filter_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "exact",
                "partial"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "total",
                    "limit",
                    "offset",
                    "count",
                    "results"
                  ],
                  "type": "object",
                  "properties": {
                    "total": {
                      "description": "Total number of items available.",
                      "type": "integer"
                    },
                    "limit": {
                      "description": "Number of results to return per page.",
                      "type": "integer"
                    },
                    "offset": {
                      "description": "The initial index from which to return the results.",
                      "type": "integer"
                    },
                    "count": {
                      "description": "number of results returned",
                      "type": "integer"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "required": [
                          "id"
                        ],
                        "type": "object",
                        "properties": {
                          "id": {
                            "title": "Id",
                            "type": "string",
                            "minLength": 1
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "v1"
        ]
      },
      "parameters": []
    }
  },
  "servers": [
    {
      "url": "https://platform.beauhurst.com/_api"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "name": "Authorization",
        "description": "Beauhurst API key",
        "in": "header"
      }
    }
  }
}
```