# Functional Area Intelligence

Lookup functional area intelligence data for a company based on a company's ID, products, departments, and roles.

Results have an internal limit of 10.

It's also possible to specify what fields from the API should be returned. By default, only some fields are returned.

Endpoint: POST /data-api/v1/company/functional_area_intelligence
Security: authorization

## Request fields (application/json):

  - `fields` (array,null)
    List of fields to be selected.
    Enum: "company_id", "product_id", "product_name", "department_id", "department_name", "department_usage_share", "department_signal_strength", "role_id", "role_name", "role_signal_strength_at_location", "role_usage_share", "signal_country_name", "signal_state_name", "signal_city_name", "last_verified_at", "is_decision_maker", "is_influencer"

  - `filters` (object, required)
    Filters to be used to narrow down the functional area intelligence data to return. Must provide either company_id OR company_ids, but not both.
    Example: {"company_id":"0252985AFE13886BC6FFA5CEBD75F4FA","departments":["0D32106BCB6DE321930CF34574EA388C","3D4C638DA5F85D025963F99FE90B1B1A","2C329EF27D7F8CB49D656D5502B9E939"],"products":[1150,805,25421,826,814,562],"roles":["2AB3F09BBBA80FF82B8FD5916954C46A","2E6BAB5FC1C661EDD7A863D4DCA3415B","21C896AFCD34E446180844D91359246E","39FD56FC1455D4D872DB14F656225740"]}

  - `filters.company_id` (any)
    A unique hexadecimal identifier for the desired field.
    Example: "1698C53EBC888758570396E0334965C1"

  - `filters.company_ids` (array)
    Array of company IDs
    Example: ["1698C53EBC888758570396E0334965C1"]

  - `filters.departments` (array, required)
    Return functional area intelligence records which are based on the provided department ids.
    Example: ["0D32106BCB6DE321930CF34574EA388C","3D4C638DA5F85D025963F99FE90B1B1A","2C329EF27D7F8CB49D656D5502B9E939"]

  - `filters.products` (array, required)
    Return functional area intelligence records which are based on the provided product ids.
    Example: [1150,805,25421,826,814,562]

  - `filters.roles` (array)
    Return functional area intelligence records which are based on the provided department role ids.
    Example: ["2AB3F09BBBA80FF82B8FD5916954C46A","2E6BAB5FC1C661EDD7A863D4DCA3415B","21C896AFCD34E446180844D91359246E","39FD56FC1455D4D872DB14F656225740"]

## Response 200 fields (application/json):

  - `count` (integer)

  - `data` (array)

  - `data.company_id` (any)
    A unique hexadecimal identifier for the desired field.
    Example: "1698C53EBC888758570396E0334965C1"

  - `data.decision_maker_presence` (boolean)

  - `data.department_id` (any)
    A unique hexadecimal identifier for the desired field.
    Example: "1698C53EBC888758570396E0334965C1"

  - `data.department_name` (string)

  - `data.department_signal_strength` (integer)

  - `data.department_usage_share` (integer)

  - `data.influencer_presence` (boolean)

  - `data.last_verified_at` (string)

  - `data.product_id` (integer)

  - `data.product_name` (string)

  - `data.role_id` (string,null)

  - `data.role_name` (string,null)

  - `data.role_signal_share` (integer,null)

  - `data.role_usage_share` (integer,null)

  - `data.signal_city_name` (string)

  - `data.signal_country_name` (string)

  - `data.signal_state_name` (string)

  - `data.total_count` (integer)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)
    Example: "The token provided is not valid"

  - `errors.source` (object)

  - `errors.title` (string, required)
    Example: "Unauthorized"

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.title` (string, required)
    Example: "Not Found"

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.detail` (string, required)
    Example: "null value where string expected"

  - `errors.source` (object, required)

  - `errors.source.pointer` (string, required)
    Example: "/data/attributes/petName"

  - `errors.title` (string, required)
    Example: "Invalid value"