# Get Contact Recommendations

Fetch recommended contacts by supplying the contact’s IDs, enabling Lusha to return similar profiles aligned by job title, seniority, and company context Use requestId to get more results from a previous search.
Endpoint: (POST) https://api.lusha.com/api/recommendations/contacts

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

## Request fields (application/json):

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

  - `contacts` (array, required)
    Contacts to get recommendations by

  - `contacts.personId` (string, required)
    Person ID to get recommendations for
    Example: "1234567890"

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

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

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

## Response 200 fields (application/json):

  - `contacts` (array, required)
    Array of contact recommendations

  - `contacts.personId` (string, required)
    Contact ID
    Example: "12345"

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

  - `contacts.name` (string, required)
    Contact name
    Example: "John Doe"

  - `contacts.jobTitle` (string, required)
    Contact job title
    Example: "Software Engineer"

  - `contacts.companyName` (string, required)
    Contact company name
    Example: "Google"

  - `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