> ## 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.

# Lookup LinkedIn company

> Starts a provisional LinkedIn company lookup job. Returns immediately with an `id` — poll `GET /v1/lookup/linkedin/{job_id}` until the status is `completed`. Provide at least one of `name`, `website`, or `linkedin_url`. Matching priority: LinkedIn URL → website → name.

<Note>
  Async. Poll with the returned `id`, or pass `webhook_url` for a callback.
</Note>

<Warning>
  Not Kernel-verified. `provenance.kernel_approved` is always `false`. Profile fields use the `linkedin_*` prefix — not Kernel firmographics.
</Warning>

## Examples

### By website

```bash curl theme={null}
curl -X POST https://api.kernel.ai/rest/v1/lookup/linkedin \
  -H "x-api-key: $KERNEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"website": "stripe.com"}'
```

```json Response (202) theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}
```

### By LinkedIn URL

```bash curl theme={null}
curl -X POST https://api.kernel.ai/rest/v1/lookup/linkedin \
  -H "x-api-key: $KERNEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_url": "https://www.linkedin.com/company/stripe"}'
```

## Request body

| Field          | Type     | Required | Description                         |
| -------------- | -------- | -------- | ----------------------------------- |
| `name`         | `string` | No\*     | Company name (low confidence alone) |
| `website`      | `string` | No\*     | Website or domain                   |
| `linkedin_url` | `string` | No\*     | LinkedIn company URL                |
| `webhook_url`  | `string` | No       | HTTPS callback URL                  |

\*At least one of `name`, `website`, or `linkedin_url`.

## Related endpoints

* [Get LinkedIn lookup result](/api-reference/endpoint/get-linkedin-lookup)
* [LinkedIn lookup result](/api-reference/schemas/linkedin-lookup-result)


## OpenAPI

````yaml POST /v1/lookup/linkedin
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:
    post:
      tags:
        - LinkedIn Lookup
      summary: Lookup LinkedIn company
      description: >-
        Starts a provisional LinkedIn company lookup job. Returns immediately
        with an `id` — poll `GET /v1/lookup/linkedin/{job_id}` until the status
        is `completed`. Provide at least one of `name`, `website`, or
        `linkedin_url`. Matching priority: LinkedIn URL → website → name.
      operationId: submitLinkedInLookup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LinkedInLookupRequest'
            examples:
              by_linkedin:
                summary: Lookup by LinkedIn URL
                value:
                  linkedin_url: https://www.linkedin.com/company/stripe
              by_website:
                summary: Lookup by website
                value:
                  website: stripe.com
              by_name:
                summary: Lookup by name only (low confidence)
                value:
                  name: Stripe
      responses:
        '202':
          description: Job accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobCreatedResponse'
              example:
                id: 550e8400-e29b-41d4-a716-446655440000
                status: processing
        '400':
          description: Invalid request body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key
        '503':
          description: Service unavailable
components:
  schemas:
    LinkedInLookupRequest:
      type: object
      description: At least one of name, website, or linkedin_url is required.
      properties:
        name:
          type: string
          minLength: 1
          description: Company name. Name-only matches are low confidence.
          example: Stripe
        website:
          type: string
          minLength: 1
          description: Company website or domain.
          example: https://stripe.com
        linkedin_url:
          type: string
          minLength: 1
          description: LinkedIn company URL.
          example: https://www.linkedin.com/company/stripe
        webhook_url:
          description: >-
            HTTPS URL to receive webhook callbacks when the job completes or
            fails. Kernel will POST the job result to this URL with an
            X-Kernel-Signature header for verification.
          type: string
          format: uri
          pattern: ^https://
          example: https://example.com/webhooks/kernel
    JobCreatedResponse:
      required:
        - id
        - status
      type: object
      properties:
        id:
          description: Unique identifier for the created job.
          type: string
          example: 550e8400-e29b-41d4-a716-446655440000
        status:
          description: Initial status of the job.
          type: string
          enum:
            - processing
    Error:
      required:
        - error
      type: object
      properties:
        error:
          description: Error description.
          type: string
          example: Entity not found
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Include your API key in the x-api-key header.

````