List FAI Departments

Resolver for the Functional Area Intelligence (FAI) taxonomy: lists the valid FAI department and role names (with their hex-encoded IDs) from the official HG Insights catalog. Returns each department's hex ID and name plus its roles (role hex ID and name). The catalog is company-independent — this tool does NOT return any company's technology usage. Use this when you need to discover or confirm the canonical name/ID of a department or role before querying departmental data — for example to resolve a valid department name, or to correlate against the departmentId/roleId fields returned by company_fai. Always look up department and role IDs here rather than guessing or fabricating them. Do NOT use this when you want how a company actually uses products across its departments — call company_fai (actual departmental tech usage) with a company domain or hg_id instead. Optionally filter by department name (case-insensitive partial match) and page with limit/offset.

Credits

Free — No credits consumed. See the full credit table for how AI Credits work.

Parameters

Name	Type	Default	Description
name	string	-	Case-insensitive partial-match filter on the department name, e.g. 'eng' matches 'Engineering'. Use it to resolve a canonical department name (and its roles) before calling company_fai. Matching is delegated to the upstream catalog. Omit to list the full department catalog.
limit	integer	-	Maximum number of departments to return (>= 0). Omit for the upstream default (returns the full catalog, which is small). Combine with offset to page.
offset	integer	-	Number of departments to skip before returning results (>= 0), for paging alongside limit. Omit to start from the first record.

Required Integrations

This tool is only available when your organization has the following integration configured in the Phoenix Integrations settings:

• HG Insights (v2) (hginsights_v2)

Use Cases

• What are the valid FAI department names? — omit all params to list the full catalog
• Resolve a canonical department name before company_fai — name (partial match → exact name + roles)
• Look up the roles within a department — name (department → its role names and IDs)
• Map a departmentId/roleId returned by company_fai back to its human-readable name
• Confirm a department exists before building a query — name (validate spelling/casing)

Example Usage

List every FAI department

{
  "tool": "list_fai_departments",
  "arguments": {}
}

Resolve the Engineering department and its roles

{
  "tool": "list_fai_departments",
  "arguments": {
    "name": "engineering"
  }
}

Look up the Sales department

{
  "tool": "list_fai_departments",
  "arguments": {
    "name": "sales",
    "limit": 5
  }
}

Response Format

Field	Type	Description
count	number	Total number of matching FAI departments (upstream total, may exceed returned rows)
data	array	List of FAI departments
data[].id	string	FAI department ID (hex-encoded)
data[].name	string	FAI department name
data[].roles	array	Roles within the department
data[].roles[].id	string	FAI role ID (hex-encoded)
data[].roles[].name	string	FAI role name

Related Tools

company_fai, company_technographic