BoardroomList

Search open senior roles (Manager to C-suite) at the 500 largest US companies by words, seniority band, function, work mode, region, city or state, minimum salary and recency. Returns up to 25 roles a page with title, level, location, posted pay range, date and a link. Use it for "VP finance roles in Texas", "remote director of engineering jobs", "what CFO roles are open". Limitation: no company names; the role page shows them to members.

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Words to search titles, e.g. \"CFO\" or \"VP supply chain\".",
      "type": "string",
      "maxLength": 120
    },
    "band": {
      "description": "Seniority: csuite, svp, vp, director, manager.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "csuite",
          "svp",
          "vp",
          "director",
          "manager"
        ]
      }
    },
    "function": {
      "description": "Job functions, e.g. Finance, Technology. Call list_filters for the full list.",
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      }
    },
    "mode": {
      "description": "Work mode.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "onsite",
          "hybrid",
          "remote"
        ]
      }
    },
    "region": {
      "description": "us = United States only, intl = outside the US.",
      "type": "string",
      "enum": [
        "us",
        "intl"
      ]
    },
    "location": {
      "description": "A city or a US state, by name or code, e.g. Chicago, Texas, TX.",
      "type": "string",
      "maxLength": 60
    },
    "min_comp": {
      "description": "Minimum posted salary in USD.",
      "type": "integer",
      "minimum": 0,
      "maximum": 2000000
    },
    "posted_within_days": {
      "description": "Only roles first seen in the last N days.",
      "type": "integer",
      "minimum": 0,
      "maximum": 365
    },
    "status": {
      "description": "open (default), new (7 days), today (24 hours), filled (last 30 days).",
      "type": "string",
      "enum": [
        "open",
        "new",
        "today",
        "filled"
      ]
    },
    "sort": {
      "description": "senior (default), newest, or comp (highest pay first).",
      "type": "string",
      "enum": [
        "senior",
        "newest",
        "comp"
      ]
    },
    "page": {
      "description": "Page number, 25 roles a page.",
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One role by id (the number at the end of its URL): title, level, function, location, work mode, posted pay, date, industry, a short redacted summary and scope, plus four similar open roles. Use it after search_roles when the user wants more on one result. Limitation: the company, full description and apply link are for members and are on the linked page.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Role id from search_roles or the role URL."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The job functions, seniority bands, industries, top cities and work modes you can filter search_roles by, each with its count of open roles. Use it to resolve a function name or to answer "how many open VP roles are there". Returns no roles.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Connector-style search over open senior roles. Returns ids for fetch. Prefer search_roles when you can filter.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Connector-style fetch of one role by the id from search. Same fields as get_role.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d+$"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}