> ## Documentation Index
> Fetch the complete documentation index at: https://dev.kernel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get LinkedIn lookup result

> Poll the status and result of a LinkedIn lookup job submitted via Lookup LinkedIn company.

Poll with the `id` from [Lookup LinkedIn company](/api-reference/endpoint/create-linkedin-lookup).

## Status lifecycle

```
pending → processing → completed | failed
```

When `completed`, `record` holds the provisional match and profile. No match still completes with `match_method: "none"` and `profile: null`.

See [LinkedIn lookup result](/api-reference/schemas/linkedin-lookup-result).

## Example

```bash curl theme={null}
curl https://api.kernel.ai/rest/v1/lookup/linkedin/550e8400-e29b-41d4-a716-446655440000 \
  -H "x-api-key: $KERNEL_API_KEY"
```

```json Response (200) — completed theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2026-06-08T14:00:32.411Z",
  "completed_at": "2026-06-08T14:00:38.151Z",
  "record": {
    "match": {
      "linkedin_url": "https://www.linkedin.com/company/stripe",
      "slug": "stripe",
      "match_method": "website",
      "confidence": "HIGH"
    },
    "profile": {
      "linkedin_name": "Stripe",
      "linkedin_website": "https://stripe.com",
      "linkedin_headcount": 8000,
      "linkedin_industry": "Financial Services",
      "linkedin_country": "United States",
      "linkedin_company_size_range": "1001-5000",
      "linkedin_company_type": "Privately Held",
      "linkedin_locality": "San Francisco, CA",
      "linkedin_address": null,
      "linkedin_founded_year": 2010,
      "linkedin_follower_count": 500000
    },
    "provenance": {
      "kernel_approved": false
    }
  }
}
```

## Related endpoints

* [Lookup LinkedIn company](/api-reference/endpoint/create-linkedin-lookup)


## OpenAPI

````yaml GET /v1/lookup/linkedin/{job_id}
openapi: 3.1.0
info:
  title: Kernel API
  description: Resolve company identities to canonical entities with a simple async API
  version: 1.0.0
  contact:
    email: support@kernel.ai
  license:
    name: MIT
servers:
  - url: https://api.kernel.ai/rest
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Entity Resolution
    description: Resolve a company to a canonical entity
  - name: Firmographics
    description: Retrieve and enrich firmographic data for resolved entities
  - name: Parentage
    description: Look up parent and top-parent entities in a corporate hierarchy
  - name: Combined
    description: Resolve an entity and run a follow-up enrichment in one call
  - name: LinkedIn Lookup
    description: Provisional LinkedIn company match jobs (not Kernel-verified)
paths:
  /v1/lookup/linkedin/{job_id}:
    get:
      tags:
        - LinkedIn Lookup
      summary: Get LinkedIn lookup result
      description: >-
        Poll the status and result of a LinkedIn lookup job submitted via Lookup
        LinkedIn company.
      operationId: getLinkedInLookupJob
      parameters:
        - name: job_id
          in: path
          description: ID of the LinkedIn lookup job
          required: true
          schema:
            type: string
            example: 550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Job status response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedInLookupJobStatus'
              examples:
                completed:
                  summary: Completed — match found
                  value:
                    id: 550e8400-e29b-41d4-a716-446655440000
                    status: completed
                    created_at: '2026-06-08T14:00:32.411Z'
                    completed_at: '2026-06-08T14:00:38.151Z'
                    record:
                      match:
                        linkedin_url: https://www.linkedin.com/company/stripe
                        slug: stripe
                        match_method: website
                        confidence: HIGH
                      profile:
                        linkedin_name: Stripe
                        linkedin_website: https://stripe.com
                        linkedin_headcount: 8000
                        linkedin_industry: Financial Services
                        linkedin_country: United States
                        linkedin_company_size_range: 1001-5000
                        linkedin_company_type: Privately Held
                        linkedin_locality: San Francisco, CA
                        linkedin_address: null
                        linkedin_founded_year: 2010
                        linkedin_follower_count: 500000
                      provenance:
                        kernel_approved: false
                pending:
                  summary: Pending — job not yet started
                  value:
                    status: pending
        '401':
          description: Missing or invalid API key
components:
  schemas:
    LinkedInLookupJobStatus:
      type: object
      properties:
        id:
          type: string
          description: Job identifier, present for non-failed jobs.
        jobid:
          type: string
          description: Job identifier, present instead of id when the job has failed.
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
        created_at:
          type: string
          format: date-time
        completed_at:
          type: string
          format: date-time
        record:
          $ref: '#/components/schemas/LinkedInLookupResponse'
        error_message:
          type: string
    LinkedInLookupResponse:
      type: object
      required:
        - match
        - profile
        - provenance
      properties:
        match:
          type: object
          required:
            - linkedin_url
            - slug
            - match_method
            - confidence
          properties:
            linkedin_url:
              type:
                - string
                - 'null'
            slug:
              type:
                - string
                - 'null'
            match_method:
              type: string
              enum:
                - linkedin_url
                - website
                - name
                - none
            confidence:
              type: string
              enum:
                - HIGH
                - MEDIUM
                - LOW
        profile:
          type:
            - object
            - 'null'
          description: >-
            LinkedIn profile fields (prefixed so they are never confused with
            Kernel firmographics).
          properties:
            linkedin_name:
              type:
                - string
                - 'null'
            linkedin_website:
              type:
                - string
                - 'null'
            linkedin_headcount:
              type:
                - number
                - 'null'
            linkedin_industry:
              type:
                - string
                - 'null'
            linkedin_country:
              type:
                - string
                - 'null'
            linkedin_company_size_range:
              type:
                - string
                - 'null'
              example: 11-50
            linkedin_company_type:
              type:
                - string
                - 'null'
              example: Privately Held
            linkedin_locality:
              type:
                - string
                - 'null'
              example: San Francisco, CA
            linkedin_address:
              type:
                - string
                - 'null'
            linkedin_founded_year:
              type:
                - number
                - 'null'
            linkedin_follower_count:
              type:
                - number
                - 'null'
            linkedin_description:
              type:
                - string
                - 'null'
        provenance:
          type: object
          required:
            - kernel_approved
          properties:
            kernel_approved:
              type: boolean
              enum:
                - false
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Include your API key in the x-api-key header.

````