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

# LinkedIn → Business Email

> Get the verified work email address for a LinkedIn profile.

Send either `linkedin_slug` or `linkedin_url`. `linkedin_slug` accepts a bare slug (e.g. `alice-123`); `linkedin_url` accepts a full profile URL (e.g. `https://www.linkedin.com/in/alice-123`). Only a confirmed work email is returned, and only one. On a miss the response still includes the `result` envelope with `email` set to `null`.

**Billing:** 4 credits per successful match (HTTP 200). Misses (404) and request errors (4xx) are not billed.



## OpenAPI

````yaml POST /api/v1/linkedin_to_business_email
openapi: 3.0.1
info:
  title: Retention API
  version: v1
  description: Retention.com identity & data resolution APIs.
servers:
  - url: https://api.rb2b.com
security: []
tags:
  - name: Identity
    description: >-
      Core Identity. Resolve a hashed email (or batch) into a shaped person
      profile.
paths:
  /api/v1/linkedin_to_business_email:
    post:
      tags:
        - LinkedIn
      summary: LinkedIn → Business Email
      description: >-
        Get the verified work email address for a LinkedIn profile.


        Send either `linkedin_slug` or `linkedin_url`. `linkedin_slug` accepts a
        bare slug (e.g. `alice-123`); `linkedin_url` accepts a full profile URL
        (e.g. `https://www.linkedin.com/in/alice-123`). Only a confirmed work
        email is returned, and only one. On a miss the response still includes
        the `result` envelope with `email` set to `null`.


        **Billing:** 4 credits per successful match (HTTP 200). Misses (404) and
        request errors (4xx) are not billed.
      operationId: linkedinToBusinessEmail
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                linkedin_slug:
                  type: string
                  description: >-
                    LinkedIn public profile slug. Provide this or
                    `linkedin_url`.
                  example: alice-123
                linkedin_url:
                  type: string
                  description: >-
                    Full LinkedIn profile URL. Used when `linkedin_slug` is
                    omitted.
                  example: https://www.linkedin.com/in/alice-123
        required: true
      responses:
        '200':
          description: Work email found (4 credits charged)
          content:
            application/json:
              schema:
                type: object
                required:
                  - result
                properties:
                  result:
                    type: object
                    required:
                      - email
                    properties:
                      email:
                        type: string
                        description: Confirmed work email address for the profile.
                        example: alice@example.com
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    enum:
                      - missing linkedin_slug or linkedin_url
                      - invalid linkedin_slug
                      - unexpected connection error
                      - unexpected error
                    description: >-
                      `missing linkedin_slug or linkedin_url`: neither input was
                      provided. `invalid linkedin_slug`: the input is not a
                      valid LinkedIn profile slug or URL. `unexpected connection
                      error` / `unexpected error`: temporary error; safe to
                      retry.
        '401':
          description: Missing, malformed, or unknown API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsufficientCreditsError'
        '403':
          description: Service not enabled for this API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceDisabledError'
        '404':
          description: No work email found (not billed)
          content:
            application/json:
              schema:
                type: object
                required:
                  - result
                properties:
                  result:
                    type: object
                    required:
                      - email
                    properties:
                      email:
                        type: string
                        nullable: true
                        description: >-
                          Always `null`; no confirmed work email matched the
                          supplied profile.
      security:
        - api_key: []
components:
  schemas:
    AuthError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          enum:
            - missing_api_key
            - invalid_api_key_format
            - invalid_api_key
          description: >-
            `missing_api_key`: no key supplied. `invalid_api_key_format`: key
            does not match the expected format. `invalid_api_key`: key does not
            belong to any account.
    InsufficientCreditsError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          enum:
            - insufficient_api_credits
        required:
          type: string
          description: Credits needed for this request.
          example: '1.0'
        remaining:
          type: string
          description: Credits currently remaining on the account.
          example: '0.0'
    ServiceDisabledError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          enum:
            - service_unavailable_for_key
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        Per-account API key. Also accepted as `Api-Key` or `Authorization:
        Bearer <key>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.