---
title: "Quickly resolve person identifiers"
method: POST
path: "/v1/person-resolve"
tags: ["Search"]
---

# Quickly resolve person identifiers

`POST /v1/person-resolve`

Resolves many person identifiers — LinkedIn slug, numeric LinkedIn user ID, LinkedIn profile URL, or LinkedIn entity URN — to full profile records in a single request.

<span>⚡ <strong>Rate limit:</strong> 1500 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> 1 credit per person resolved&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `people` union[], required — People to resolve. Each entry is an { identifier, value } pair where identifier is "linkedinSlug", "linkedinUserId", "linkedinUrl", or "entityUrn". Max 100 per request. You are charged only for the ones that resolve.
    - union
      - object
        - `identifier` 'linkedinUrl', required
        - `value` string, required — LinkedIn profile URL (e.g. 'https://www.linkedin.com/in/williamhgates').
      - object
        - `identifier` 'linkedinSlug', required
        - `value` string, required — LinkedIn profile slug (e.g. 'williamhgates').
      - object
        - `identifier` 'linkedinUserId', required
        - `value` string, required — LinkedIn numeric user ID (e.g. '251749025'). This is NOT derived from the profile URL.
      - object
        - `identifier` 'entityUrn', required
        - `value` string, required — LinkedIn entity URN (e.g. 'ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc'). The opaque id LinkedIn uses internally.

## Response `200`

Default Response

- object
  - `output` object, required
    - `data` object[], required
      - `identifier` 'linkedinUrl' | 'linkedinSlug' | 'linkedinUserId' | 'entityUrn', required — The identifier type you supplied, echoed back.
      - `value` string, required — The identifier value you supplied, echoed back.
      - `found` boolean, required
      - `person` object, nullable
        - `articles` object[], nullable
          - `id` string, nullable
          - `title` string, nullable
          - `date_published` string, nullable
        - `certifications` object[], nullable
          - `title` string, nullable
          - `credential_id` string, nullable
          - `verify_url` string, nullable
          - `summary` string, nullable
          - `linkedin_company_id` string, nullable
          - `company_name` string, nullable
          - `date` string, nullable
        - `connection_count` number, nullable
        - `courses` object[], nullable
          - `title` string, nullable
          - `course_number` string, nullable
          - `association` unknown
        - `dob` string, nullable
        - `education` object[], nullable
          - `school_id` string, nullable
          - `school_name` string, nullable
          - `field_of_study_id` string, nullable
          - `field_of_study_name` string, nullable
          - `degree` string, nullable
          - `grade` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `activities` string, nullable
          - `notes` string, nullable
        - `experiences` object[], nullable
          - `linkedin_company_id` string, nullable
          - `is_current` boolean, nullable
          - `company_name` string, nullable
          - `locality` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
          - `job_function` string[], nullable
          - `employment_type` string[], nullable
          - `academic_qualification` string[], nullable
          - `company_start_date` string, nullable
          - `company_end_date` string, nullable
        - `first_name` string, nullable
        - `follower_count` number, nullable
        - `headline` string, nullable
        - `industry_name` string, nullable
        - `inferred_location` object, nullable
          - `street_address` string, nullable
          - `neighborhood` string, nullable
          - `city` string, nullable
          - `state_name` string, nullable
          - `state_code` string, nullable
          - `county` string, nullable
          - `postal_code` string, nullable
          - `country_code` string, nullable
          - `country_name` string, nullable
          - `coordinates` object, nullable
            - `lat` number, required
            - `lon` number, required
          - `timezone` string, nullable
          - `full_address` string, nullable
          - `formatted_address` string, nullable
        - `interests` string[], nullable
        - `last_name` string, nullable
        - `locality` string, nullable
        - `name` string, nullable
        - `patents` object[], nullable
          - `id` string, nullable
          - `title` string, nullable
          - `country` string, nullable
          - `number` string, nullable
          - `description` string, nullable
          - `url` string, nullable
          - `date` string, nullable
        - `profile_pic` string, nullable
        - `projects` object[], nullable
          - `project_id` string, nullable
          - `project_title` string, nullable
          - `project_url` string, nullable
          - `project_summary` string, nullable
          - `is_current` boolean, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
        - `publications` object[], nullable
          - `collaborators` object[], nullable
            - `name` string, nullable
            - `url` string, nullable
          - `date` string, nullable
          - `id` string, nullable
          - `publisher` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `url` string, nullable
        - `skills` string[], nullable
        - `primary_slug` string, required
        - `slugs` string[], nullable
        - `summary` string, nullable
        - `url` string, nullable
        - `user_id` string, nullable
        - `volunteering` object[], nullable
          - `role` string, nullable
          - `is_current` boolean, nullable
          - `cause` string, nullable
          - `summary` string, nullable
          - `linkedin_company_id` string, nullable
          - `company_name` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
        - `tenures` object[], nullable
          - `linkedin_company_id` string, nullable
          - `company_name` string, nullable
          - `date_range` object, required
            - `gte` string, nullable
            - `lte` string, nullable
          - `range_length_days` number, nullable
          - `titles` string[], required
          - `localities` string[], required
        - `career_began_at` string, nullable
        - `tags` string[], nullable
        - `entity_urn` string, nullable
        - `open_to_work` boolean, nullable
        - `premium` boolean, nullable
        - `influencer` boolean, nullable
        - `organizations` object[], nullable
          - `name` string, nullable
          - `end_date` string, nullable
          - `title` string, nullable
          - `start_date` string, nullable
        - `entity_urns` string[], nullable
        - `is_hiring` boolean, nullable
        - `websites` string[], nullable
        - `is_verified` boolean, nullable
        - `verifications` object, nullable
          - `is_verified` boolean, nullable
          - `joined_date` string, nullable
          - `verification_types` object[], nullable
            - `title` string, nullable
            - `subtitle` string, nullable
            - `description` string, nullable
        - `is_top_voice` boolean, nullable
        - `current_job` object, nullable
          - `linkedin_company_id` string, nullable
          - `is_current` boolean, nullable
          - `company_name` string, nullable
          - `locality` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
          - `job_function` string[], nullable
          - `employment_type` string[], nullable
          - `academic_qualification` string[], nullable
          - `company_start_date` string, nullable
          - `company_end_date` string, nullable
        - `custom_data` object, nullable
        - `relevance_score` number, nullable
        - `last_sort_key` string, nullable
        - `last_updated_at` string, nullable
        - `languages` object[], nullable
          - `name` string, nullable
          - `proficiency_id` string, nullable
          - `proficiency_name` string, nullable
        - `detailed_education` object[], nullable
          - `school_details` object, nullable
            - `linkedin_ids` string[], nullable
            - `li_org_id` string, nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `preferred_name` string, nullable
          - `school_id` string, nullable
          - `school_name` string, nullable
          - `field_of_study_id` string, nullable
          - `field_of_study_name` string, nullable
          - `degree` string, nullable
          - `grade` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `activities` string, nullable
          - `notes` string, nullable
        - `detailed_work_experiences` object[], nullable
          - `company_details` object, nullable
            - `linkedin_ids` string[], nullable
            - `li_org_id` string, nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `preferred_name` string, nullable
          - `crunchbase_slug` string, nullable
          - `linkedin_company_id` string, nullable
          - `is_current` boolean, nullable
          - `company_name` string, nullable
          - `locality` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
          - `job_function` string[], nullable
          - `employment_type` string[], nullable
          - `academic_qualification` string[], nullable
          - `company_start_date` string, nullable
          - `company_end_date` string, nullable
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/720c63a313eb/schema)