Skip to main content
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:
HeaderTypeDescription
apikeystringYour API key for access
Path Parameters:
ParameterTypeDescription
usernamestringUsername of the LinkedIn profile
Response Headers
HeaderDescription
RateLimit-LimitAllowed limit in the timeframe.
RateLimit-RemainingNumber of available requests remaining.
RateLimit-ResetThe time remaining, in seconds, until the rate limit quota is reset.
X-RateLimit-Limit-SecondThe time limit, in number of seconds.
X-RateLimit-Limit-MinuteThe time limit, in number of minutes.
X-RateLimit-Limit-DayThe time limit, in number of days.
X-RateLimit-Limit-MonthThe time limit, in number of months.
X-RateLimit-Limit-YearThe time limit, in number of years.
X-RateLimit-Remaining-SecondThe number of seconds still left in the time frame.
X-RateLimit-Remaining-MinuteThe number of minutes still left in the time frame.
X-RateLimit-Remaining-DayThe number of days still left in the time frame.
X-RateLimit-Remaining-MonthThe number of months still left in the time frame.
X-RateLimit-Remaining-YearThe number of years still left in the time frame.
Retry-AfterThis 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:
CodeDescription
200Verification info fetched successfully
401Unauthorized (invalid API key)
404Incorrect API endpoint