Company search available fields

Introduction

This endpoint returns metadata describing every filter accepted by Company search. It lets integrations (for example Clay) discover available inputs dynamically instead of hardcoding the filter list, so new search capabilities surface automatically as we release them.

Like Usage, this route uses GET, takes no request body, and costs 0 credits.

Looking for people filters? See People search available fields.

Endpoint

Method	URL	Describes
`GET`	`/v2/search/companies/available-fields`	Company Search

Authorization

apikey string required

Your API key from the developer dashboard. Pass it via Authorization: Bearer YOUR_API_KEY header.

Response structure

success boolean

true if the request was processed successfully

error null

Always null on success

dataobject

Container for the discovered fields

Show child attributesHide child attributes

object string

Always "search_fields"

entity string

Always "company" for this endpoint

fields Field[]

List of accepted filters (see field shape below)

fieldsobject

One accepted search filter

Show child attributesHide child attributes

name string

Filter name, used as a key in the search request body

type string

string, boolean, number, range, location, date-time, or string | string[]

required boolean

Whether the filter is mandatory (always false today; all filters are optional)

description string

Human-readable explanation of the filter

example unknown

Example value, when helpful (optional)

allowedValues unknown[]

Closed set of accepted values, when applicable (e.g. [true, false]) (optional)

properties object

Sub-field shapes for range and location filters (optional)

Code examples

Code Examples

curl https://api.reversecontact.com/v2/search/companies/available-fields \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  "https://api.reversecontact.com/v2/search/companies/available-fields",
  {
    headers: {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.data.fields.map((f) => f.name));

import requests

response = requests.get(
    "https://api.reversecontact.com/v2/search/companies/available-fields",
    headers={
        "Authorization": "Bearer YOUR_API_KEY"
    }
)

data = response.json()
print([f["name"] for f in data["data"]["fields"]])

Example response

Example Response

200 - Success

{
  "success": true,
  "data": {
    "object": "search_fields",
    "entity": "company",
    "fields": [
      {
        "name": "companyName",
        "type": "string",
        "required": false,
        "description": "Filter by company name"
      },
      {
        "name": "industry",
        "type": "string | string[]",
        "required": false,
        "description": "Industry name or array of industries"
      },
      {
        "name": "employeeCountRange",
        "type": "range",
        "required": false,
        "description": "Filter by employee count range. Both bounds are optional and inclusive (range 0 - 1,000,000,000).",
        "properties": {
          "min": { "type": "number", "description": "Minimum value, inclusive" },
          "max": { "type": "number", "description": "Maximum value, inclusive" }
        }
      }
    ]
  },
  "error": null,
  "quotas": {
    "creditsConsumed": 0,
    "workspace": {
      "id": "ws_abc123",
      "credits": { "total": 10000, "used": 4521, "left": 5479 }
    }
  },
  "metadata": {
    "requestId": "req_f1e2l3d4s5",
    "executionTimeMs": 3
  }
}