# Get Company Recommendations

Get company recommendations based on other companies.  Use requestId to get more results from a previous search.
Endpoint: (POST) https://api.lusha.com/api/recommendations/companies

Endpoint: POST /api/recommendations/companies
Security: ApiKeyAuth

## Request fields (application/json):

  - `requestId` (string)
    Request ID for getting more results (optional)
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `companies` (array, required)
    Company IDs to get recommendations by

  - `companies.companyId` (string, required)
    Company ID to get recommendations for
    Example: "1234567890"

  - `exclude` (array)
    Company IDs to exclude from results

  - `limit` (number)
    Number of recommendations to return (max 25)

## Response 200 fields (application/json):

  - `companies` (array, required)
    Array of company recommendations

  - `companies.companyId` (string, required)
    Company ID
    Example: "12345"

  - `companies.name` (string, required)
    Company name
    Example: "Lusha"

  - `companies.fqdn` (string, required)
    Company FQDN
    Example: "lusha.com"

  - `companies.description` (string, required)
    Company description
    Example: "Example company description"

  - `requestId` (string, required)
    Request ID for getting more results
    Example: "req_123456789"

  - `count` (number, required)
    Total number of recommendations returned
    Example: 10

  - `creditsCharged` (number, required)
    Number of credits charged for the recommendations
    Example: 3

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 403 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 500 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message


## Response 402 fields