> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrichment.qode.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Fetch LinkedIn verification information by username.

The **LinkedIn Verification API** provides a single endpoint to retrieve LinkedIn verification data. Use this endpoint to:

1. **Get Verification Info**: Retrieve verification information about a LinkedIn profile by their username, including identity verification, educational institution verification, and workplace verification.

All endpoints are documented below, generated directly from our OpenAPI specification.

***

## Endpoint

GET /api/v1/linkedin/\{username}/verification

**Headers:**

| Header | Type   | Description             |
| ------ | ------ | ----------------------- |
| apikey | string | Your API key for access |

**Path Parameters:**

| Parameter | Type   | Description                      |
| --------- | ------ | -------------------------------- |
| username  | string | Username of the LinkedIn profile |

**Response Headers**

| Header                       | Description                                                                                                              |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| RateLimit-Limit              | Allowed limit in the timeframe.                                                                                          |
| RateLimit-Remaining          | Number of available requests remaining.                                                                                  |
| RateLimit-Reset              | The time remaining, in seconds, until the rate limit quota is reset.                                                     |
| X-RateLimit-Limit-Second     | The time limit, in number of seconds.                                                                                    |
| X-RateLimit-Limit-Minute     | The time limit, in number of minutes.                                                                                    |
| X-RateLimit-Limit-Day        | The time limit, in number of days.                                                                                       |
| X-RateLimit-Limit-Month      | The time limit, in number of months.                                                                                     |
| X-RateLimit-Limit-Year       | The time limit, in number of years.                                                                                      |
| X-RateLimit-Remaining-Second | The number of seconds still left in the time frame.                                                                      |
| X-RateLimit-Remaining-Minute | The number of minutes still left in the time frame.                                                                      |
| X-RateLimit-Remaining-Day    | The number of days still left in the time frame.                                                                         |
| X-RateLimit-Remaining-Month  | The number of months still left in the time frame.                                                                       |
| X-RateLimit-Remaining-Year   | The number of years still left in the time frame.                                                                        |
| Retry-After                  | This header appears on 429 errors, indicating how long the upstream service is expected to be unavailable to the client. |

**Response:**

Returns a `LinkedInVerification` object with the following structure:

* `username` (string): The LinkedIn username
* `joinedDate` (string): ISO date-time string of when the user joined LinkedIn
* `verifiedInfo` (object): Dynamic object with verification types as keys, each containing an array of verification items:
  * `Identity`: Array of identity verification items
  * `Educational institution`: Array of educational institution verification items (supports multiple values)
  * `Workplace`: Array of workplace verification items (supports multiple values)
  * Each verification item contains:
    * `Date` (string): Date information (e.g., "Less than 1 year ago", "Over 15 years ago")
    * `Value` (string): Verification value (e.g., "Verified by CLEAR using government ID")

**Response Codes:**

| Code | Description                            |
| ---- | -------------------------------------- |
| 200  | Verification info fetched successfully |
| 401  | Unauthorized (invalid API key)         |
| 404  | Incorrect API endpoint                 |