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

# Find profile by email

> Call reverse_email through the Plyne API or MCP. Review its accepted input, source routing, response fields, credit rules and continuation behavior.

Read documented public email data. Returned fields follow the documented dataset; unavailable fields remain absent.

## Usage

* Normalized search records retain reviewed fields outside their common schema in additional\_fields.\<provider>. Source-native data tools already expose their documented business fields directly in data.

## API

Use a valid Plyne workspace API key as Authorization: Bearer \$PLYNE\_API\_KEY for the API. Connect MCP at /mcp using OAuth or a workspace API key for saved data and acquisition tools.

```bash theme={null}
curl "$PLYNE_API_URL/v1/tools/reverse_email/execute" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: REPLACE_WITH_UNIQUE_REQUEST_ID' \
  --data '{
  "email": "person@example.com"
}'
```

Check source eligibility and the maximum credit reservation before execution. Planning makes no provider request and requires no idempotency key.

```bash theme={null}
curl "$PLYNE_API_URL/v1/tools/reverse_email/plan" \
  -H "Authorization: Bearer $PLYNE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "email": "person@example.com"
}'
```

## MCP

Connect to `/mcp` using OAuth or a workspace API key. The same connection includes saved-data and acquisition tools. Call the same tool with `idempotency_key` inside its arguments.

```json theme={null}
{
  "arguments": {
    "email": "person@example.com",
    "idempotency_key": "REPLACE_WITH_UNIQUE_REQUEST_ID"
  },
  "name": "reverse_email"
}
```

## Sources and routing

Omit routing to use eligible sources in the default order. Set routing.providers to an ordered chain, or one source to run only that source. Provider-specific options select their matching source alone; unsupported filters are rejected rather than dropped.

Supported source IDs: `harvest`. Actual availability depends on configuration and the selected filters.

## Credits and continuation

0.2 credits per usable request. Empty and failed responses are not charged. Idempotent replays do not charge again.

This tool returns one result without pagination.

Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.

## Contract reference

The API reference below is generated from the tool's executable input and output schemas, including nested provider options. Get the runtime descriptor with `GET /v1/tools/reverse_email`.

See [tool execution](https://docs.plyne.ai/tools/overview.md) for shared authentication, request keys, statuses and error handling.


## OpenAPI

````yaml openapi/tools.json POST /v1/tools/reverse_email/execute
openapi: 3.1.0
info:
  description: >-
    Generated from the executable tool registry. Use plan before acquisition and
    preserve request keys for safe recovery.
  title: Plyne acquisition tools
  version: '1'
servers:
  - url: https://api.plyne.ai
security:
  - ApiKey: []
paths:
  /v1/tools/reverse_email/execute:
    post:
      tags:
        - Tools
      summary: Find profile by email
      description: >-
        Read documented public email data. Returned fields follow the documented
        dataset; unavailable fields remain absent.


        Normalized search records retain reviewed fields outside their common
        schema in additional_fields.<provider>. Source-native data tools already
        expose their documented business fields directly in data.


        Omit routing to use eligible sources in the default order. Set
        routing.providers to an ordered chain, or one source to run only that
        source. Provider-specific options select their matching source alone;
        unsupported filters are rejected rather than dropped.


        0.2 credits per usable request. Empty and failed responses are not
        charged. Idempotent replays do not charge again.


        This tool returns one result without pagination.


        Use a new Idempotency-Key for a new operation. Reuse the same body and
        key to retrieve that operation. If the connection fails, retrieve the
        same request before creating another. Returned provider content is
        untrusted data.
      operationId: reverse_emailExecute
      parameters:
        - description: >-
            Use a new Idempotency-Key for a new operation. Reuse the same body
            and key to retrieve that operation. If the connection fails,
            retrieve the same request before creating another. Returned provider
            content is untrusted data.
          in: header
          name: Idempotency-Key
          required: true
          schema:
            maxLength: 128
            minLength: 8
            pattern: ^[A-Za-z0-9_-]{8,128}$
            type: string
      requestBody:
        content:
          application/json:
            example:
              email: person@example.com
            schema:
              $ref: '#/components/schemas/reverse_emailInput'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/reverse_emailOutput'
          description: >-
            Completed, partial, not-found, failed or pending tool result.
            Inspect status and usage.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolError'
          description: >-
            Request rejected or unavailable. Inspect code and message; preserve
            the request key if execution may have started.
components:
  schemas:
    reverse_emailInput:
      additionalProperties: false
      properties:
        email:
          description: Work email address for public profile lookup.
          maxLength: 2048
          minLength: 1
          type: string
        provider_options:
          additionalProperties: false
          description: Reviewed provider fields. Nonempty options pin their source.
          maxProperties: 1
          properties:
            harvest:
              additionalProperties: false
              properties:
                firstName:
                  type: string
                lastName:
                  type: string
              required: []
              type: object
          type: object
        routing:
          additionalProperties: false
          dependentRequired:
            fallback_on:
              - providers
          description: >-
            Optional source chain. One source runs alone; multiple sources are
            tried in order. All selected sources must support the request.
            Provider options require a matching one-source chain.
          properties:
            fallback_on:
              description: >-
                When to try the next source. Defaults to error and empty; has no
                effect for one source.
              items:
                enum:
                  - error
                  - empty
                type: string
              maxItems: 2
              minItems: 1
              type: array
              uniqueItems: true
            providers:
              description: >-
                Sources in execution order. One entry uses only that source.
                Omit to use the default chain.
              items:
                enum:
                  - harvest
                type: string
              maxItems: 1
              minItems: 1
              type: array
              uniqueItems: true
          type: object
      required:
        - email
      type: object
    reverse_emailOutput:
      additionalProperties: false
      properties:
        data:
          additionalProperties: false
          properties:
            about:
              type: string
            causes:
              items:
                type: string
              type: array
            certifications:
              items:
                additionalProperties: false
                properties:
                  issuedAt:
                    type: string
                  issuedBy:
                    type: string
                  issuedByLink:
                    format: uri
                    type:
                      - string
                      - 'null'
                  issuedByLogo:
                    additionalProperties: false
                    properties:
                      sizes:
                        items:
                          additionalProperties: false
                          properties:
                            height:
                              type: integer
                            url:
                              format: uri
                              type: string
                            width:
                              type: integer
                          type: object
                        type: array
                      url:
                        format: uri
                        type:
                          - string
                          - 'null'
                    type: object
                  link:
                    format: uri
                    type:
                      - string
                      - 'null'
                  title:
                    type: string
                type: object
              type: array
            companyWebsites:
              items: {}
              type: array
            composeOptionType:
              type: string
            connectedApps:
              description: >-
                Apps the member connected to the profile (Duolingo, LinkedIn
                Recruiter, …), which LinkedIn shows with the licenses &
                certifications; they are not part of `certifications`.
              items:
                additionalProperties: false
                properties:
                  companyLinkedinUrl:
                    format: uri
                    type: string
                  companyLogo:
                    additionalProperties: false
                    properties:
                      sizes:
                        items:
                          additionalProperties: false
                          properties:
                            height:
                              type: integer
                            url:
                              format: uri
                              type: string
                            width:
                              type: integer
                          type: object
                        type: array
                      url:
                        format: uri
                        type:
                          - string
                          - 'null'
                    type: object
                  name:
                    type: string
                  sourcedAt:
                    description: The month shown next to the source.
                    type:
                      - string
                      - 'null'
                  sourcedFrom:
                    type: string
                type: object
              type: array
            connectionsCount:
              type: integer
            courses:
              items:
                additionalProperties: false
                properties:
                  associatedWith:
                    type: string
                  associatedWithLink:
                    format: uri
                    type:
                      - string
                      - 'null'
                  title:
                    type: string
                type: object
              type: array
            coverPicture:
              additionalProperties: false
              properties:
                sizes:
                  items:
                    additionalProperties: false
                    properties:
                      height:
                        type: integer
                      url:
                        format: uri
                        type: string
                      width:
                        type: integer
                    type: object
                  type: array
                url:
                  format: uri
                  type:
                    - string
                    - 'null'
              type: object
            creator:
              type: boolean
            currentPosition:
              items:
                additionalProperties: false
                properties:
                  companyId:
                    type: string
                  companyLinkedinUrl:
                    format: uri
                    type: string
                  companyLogo:
                    additionalProperties: false
                    properties:
                      sizes:
                        items:
                          additionalProperties: false
                          properties:
                            height:
                              type: integer
                            url:
                              format: uri
                              type: string
                            width:
                              type: integer
                          type: object
                        type: array
                      url:
                        format: uri
                        type:
                          - string
                          - 'null'
                    type: object
                  companyName:
                    type: string
                  companyUniversalName:
                    type: string
                  description:
                    type: string
                  duration:
                    type: string
                  employmentType:
                    type: string
                  endDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  experienceGroupId:
                    type: string
                  geoId:
                    description: >-
                      LinkedIn geo id of the position's location, the id the
                      search endpoints take as `geoId`; null when the position
                      has none.
                    type:
                      - string
                      - 'null'
                  location:
                    type: string
                  multiLocaleCompanyName:
                    description: >-
                      The company name the member wrote per language, when the
                      languages differ.
                    items:
                      additionalProperties: false
                      properties:
                        companyName:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleDescription:
                    description: >-
                      The description in every language the member wrote it in;
                      absent for a single language. `description` is the English
                      one, else the one in the profile's primary language.
                    items:
                      additionalProperties: false
                      properties:
                        description:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleLocation:
                    description: >-
                      The location the member wrote per language, when the
                      languages differ.
                    items:
                      additionalProperties: false
                      properties:
                        locale:
                          type: string
                        location:
                          type: string
                      type: object
                    type: array
                  multiLocalePosition:
                    description: >-
                      The title in every language the member wrote it in, on
                      profiles with more than one language; absent when the
                      title has one language. `position` is the English title,
                      else the one in the profile's primary language.
                    items:
                      additionalProperties: false
                      properties:
                        locale:
                          type: string
                        position:
                          type: string
                      type: object
                    type: array
                  position:
                    type: string
                  skills:
                    items:
                      type: string
                    type: array
                  startDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  workplaceType:
                    type: string
                type: object
              type: array
            education:
              items:
                additionalProperties: false
                properties:
                  degree:
                    type: string
                  endDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  fieldOfStudy:
                    type: string
                  grade:
                    description: >-
                      The grade the member gave for this education (LinkedIn's
                      "Grade" field, "Note" in German), as written; null when
                      none is given. On profiles with more than one language,
                      the English one, else the one in the profile's primary
                      language.
                    type:
                      - string
                      - 'null'
                  multiLocaleDegree:
                    description: >-
                      The degree in every language the member wrote it in, on
                      profiles with more than one language; absent for a single
                      language. `degree` is the English one, else the one in the
                      profile's primary language.
                    items:
                      additionalProperties: false
                      properties:
                        degree:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleDescription:
                    description: >-
                      The description in every language the member wrote it in,
                      as `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        description:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleFieldOfStudy:
                    description: >-
                      The field of study in every language the member wrote it
                      in, as `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        fieldOfStudy:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleGrade:
                    description: >-
                      The grade in every language the member wrote it in, as
                      `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        grade:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleInsights:
                    description: >-
                      The grade and the activities and societies in every
                      language the member wrote either in, as
                      `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        insights:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleSchoolName:
                    description: >-
                      The school name the member wrote per language, when the
                      languages differ.
                    items:
                      additionalProperties: false
                      properties:
                        locale:
                          type: string
                        schoolName:
                          type: string
                      type: object
                    type: array
                  period:
                    type: string
                  schoolId:
                    type: string
                  schoolLinkedinUrl:
                    format: uri
                    type: string
                  schoolLogo:
                    additionalProperties: false
                    properties:
                      sizes:
                        items:
                          additionalProperties: false
                          properties:
                            height:
                              type: integer
                            url:
                              format: uri
                              type: string
                            width:
                              type: integer
                          type: object
                        type: array
                      url:
                        format: uri
                        type:
                          - string
                          - 'null'
                    type: object
                  schoolName:
                    type: string
                  skills:
                    items:
                      type: string
                    type: array
                  startDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                type: object
              type: array
            emails:
              items:
                additionalProperties: false
                properties:
                  catchAllDomain:
                    type: boolean
                  deliverable:
                    type: boolean
                  email:
                    format: email
                    type: string
                  free:
                    type: boolean
                  qualityScore:
                    type: integer
                  status:
                    type: string
                  validEmailServer:
                    type: boolean
                type: object
              type: array
            experience:
              items:
                additionalProperties: false
                properties:
                  companyId:
                    type: string
                  companyLinkedinUrl:
                    format: uri
                    type: string
                  companyLogo:
                    additionalProperties: false
                    properties:
                      sizes:
                        items:
                          additionalProperties: false
                          properties:
                            height:
                              type: integer
                            url:
                              format: uri
                              type: string
                            width:
                              type: integer
                          type: object
                        type: array
                      url:
                        format: uri
                        type:
                          - string
                          - 'null'
                    type: object
                  companyName:
                    type: string
                  companyUniversalName:
                    type: string
                  description:
                    type: string
                  duration:
                    type: string
                  employmentType:
                    type: string
                  endDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  experienceGroupId:
                    type: string
                  geoId:
                    description: >-
                      LinkedIn geo id of the position's location, the id the
                      search endpoints take as `geoId`; null when the position
                      has none.
                    type:
                      - string
                      - 'null'
                  location:
                    type: string
                  multiLocaleCompanyName:
                    description: >-
                      The company name the member wrote per language, when the
                      languages differ.
                    items:
                      additionalProperties: false
                      properties:
                        companyName:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleDescription:
                    description: >-
                      The description in every language the member wrote it in;
                      absent for a single language. `description` is the English
                      one, else the one in the profile's primary language.
                    items:
                      additionalProperties: false
                      properties:
                        description:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleLocation:
                    description: >-
                      The location the member wrote per language, when the
                      languages differ.
                    items:
                      additionalProperties: false
                      properties:
                        locale:
                          type: string
                        location:
                          type: string
                      type: object
                    type: array
                  multiLocalePosition:
                    description: >-
                      The title in every language the member wrote it in, on
                      profiles with more than one language; absent when the
                      title has one language. `position` is the English title,
                      else the one in the profile's primary language.
                    items:
                      additionalProperties: false
                      properties:
                        locale:
                          type: string
                        position:
                          type: string
                      type: object
                    type: array
                  position:
                    type: string
                  skills:
                    items:
                      type: string
                    type: array
                  startDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  workplaceType:
                    type: string
                type: object
              type: array
            featured:
              additionalProperties: false
              properties:
                images:
                  items:
                    additionalProperties: false
                    type: object
                  type: array
                link:
                  format: uri
                  type:
                    - string
                    - 'null'
                slides:
                  items:
                    additionalProperties: false
                    properties:
                      description:
                        type:
                          - string
                          - 'null'
                      image:
                        additionalProperties: false
                        properties:
                          url:
                            format: uri
                            type: string
                        type: object
                      subtitle:
                        type: string
                      title:
                        type: string
                      url:
                        format: uri
                        type: string
                    type: object
                  type: array
                subtitle:
                  type:
                    - string
                    - 'null'
                title:
                  type:
                    - string
                    - 'null'
              type: object
            firstName:
              type: string
            followerCount:
              type: integer
            givenRecommendations:
              description: >-
                Recommendations the member wrote for others: the first entries
                the profile shows, up to the first 20 when the profile has many
                received recommendations. `sectionTotals.givenRecommendations`
                holds their total.
              items:
                additionalProperties: false
                properties:
                  description:
                    type: string
                  givenAt:
                    type: string
                  givenTo:
                    type: string
                  givenToHeadline:
                    type:
                      - string
                      - 'null'
                  givenToLink:
                    format: uri
                    type: string
                  givenToPicture:
                    additionalProperties: false
                    properties:
                      sizes:
                        items:
                          additionalProperties: false
                          properties:
                            height:
                              type: integer
                            url:
                              format: uri
                              type: string
                            width:
                              type: integer
                          type: object
                        type: array
                      url:
                        format: uri
                        type:
                          - string
                          - 'null'
                    type: object
                type: object
              type: array
            headline:
              type: string
            hiring:
              type: boolean
            hiringCard:
              additionalProperties: false
              description: 'The profile''s "Hiring" card: the role the member hires for.'
              properties:
                companyName:
                  type:
                    - string
                    - 'null'
                description:
                  description: The card's text as shown.
                  type: string
                jobId:
                  type: string
                jobTitle:
                  type: string
                jobUrl:
                  format: uri
                  type: string
                location:
                  type:
                    - string
                    - 'null'
                postedAgo:
                  description: How long ago the job was posted, as the card says it.
                  type:
                    - string
                    - 'null'
                workplaceType:
                  type:
                    - string
                    - 'null'
              type:
                - object
                - 'null'
            honorsAndAwards:
              items:
                additionalProperties: false
                properties:
                  associatedWith:
                    type: string
                  associatedWithLink:
                    format: uri
                    type:
                      - string
                      - 'null'
                  description:
                    type: string
                  issuedAt:
                    type: string
                  issuedBy:
                    type: string
                  title:
                    type: string
                type: object
              type: array
            id:
              type: string
            influencer:
              type: boolean
            interests:
              items:
                additionalProperties: false
                properties:
                  elements:
                    items:
                      additionalProperties: false
                      properties:
                        caption:
                          type: string
                        image:
                          additionalProperties: false
                          properties:
                            url:
                              format: uri
                              type: string
                          type: object
                        link:
                          format: uri
                          type:
                            - string
                            - 'null'
                        subtitle:
                          type:
                            - string
                            - 'null'
                        title:
                          type: string
                      type: object
                    type: array
                  interestName:
                    type: string
                type: object
              type: array
            languages:
              items:
                additionalProperties: false
                properties:
                  name:
                    type: string
                  proficiency:
                    type: string
                type: object
              type: array
            lastName:
              type: string
            linkedinUrl:
              format: uri
              type: string
            location:
              additionalProperties: false
              properties:
                countryCode:
                  type: string
                linkedinText:
                  type: string
                parsed:
                  additionalProperties: false
                  properties:
                    city:
                      type: string
                    country:
                      type: string
                    countryCode:
                      type: string
                    countryFull:
                      type: string
                    regionCode:
                      type:
                        - string
                        - 'null'
                    state:
                      type: string
                    text:
                      type: string
                  type: object
              type: object
            memorialized:
              type: boolean
            moreProfiles:
              items:
                additionalProperties: false
                properties:
                  firstName:
                    type: string
                  id:
                    type: string
                  lastName:
                    type: string
                  linkedinUrl:
                    format: uri
                    type: string
                  position:
                    type: string
                  publicIdentifier:
                    type: string
                type: object
              type: array
            multiLocaleAbout:
              description: >-
                The About text in the profile's primary language and in English,
                when the member wrote both and they differ; `about` is the
                English one. Other language versions of the About section are
                not returned.
              items:
                additionalProperties: false
                properties:
                  about:
                    type: string
                  locale:
                    type: string
                type: object
              type: array
            multiLocaleHeadline:
              items:
                additionalProperties: false
                properties:
                  headline:
                    type: string
                  locale:
                    type: string
                type: object
              type: array
            objectUrn:
              type: string
            openToWork:
              type: boolean
            openToWorkCard:
              additionalProperties: false
              description: >-
                The profile's "Open to work" card, when it shows one to
                everyone. Its job titles, other locations and start date are
                only on LinkedIn's details page and are not returned.
              properties:
                description:
                  description: The card's text as shown.
                  type: string
                detailsUrl:
                  format: uri
                  type: string
                locations:
                  description: The locations the card names (the first preferred one).
                  items:
                    type: string
                  type: array
                moreLocations:
                  description: How many more preferred locations there are ("+2 more").
                  type: integer
                visibility:
                  type: string
                workplaceTypes:
                  items:
                    type: string
                  type: array
              type:
                - object
                - 'null'
            organizations:
              items:
                additionalProperties: false
                properties:
                  companyLinkedinUrl:
                    format: uri
                    type: string
                  description:
                    type: string
                  endDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  logo:
                    format: uri
                    type:
                      - string
                      - 'null'
                  name:
                    type: string
                  positionHeld:
                    type:
                      - string
                      - 'null'
                  startDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                type: object
              type: array
            patents:
              items:
                additionalProperties: false
                properties:
                  description:
                    type: string
                  issuedAt:
                    type: string
                  number:
                    type: string
                  title:
                    type: string
                  url:
                    format: uri
                    type:
                      - string
                      - 'null'
                type: object
              type: array
            photo:
              format: uri
              type: string
            premium:
              type: boolean
            primaryLocale:
              additionalProperties: false
              properties:
                country:
                  type: string
                language:
                  type: string
              type: object
            profileActions:
              items:
                additionalProperties: false
                properties:
                  label:
                    type: string
                  url:
                    format: uri
                    type: string
                type: object
              type: array
            profileLocales:
              items:
                additionalProperties: false
                properties:
                  country:
                    type: string
                  language:
                    type: string
                type: object
              type: array
            profilePicture:
              additionalProperties: false
              properties:
                sizes:
                  items:
                    additionalProperties: false
                    properties:
                      height:
                        type: integer
                      url:
                        format: uri
                        type: string
                      width:
                        type: integer
                    type: object
                  type: array
                url:
                  format: uri
                  type:
                    - string
                    - 'null'
              type: object
            profileTopEducation:
              items:
                additionalProperties: false
                properties:
                  degree:
                    type: string
                  endDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  fieldOfStudy:
                    type: string
                  grade:
                    description: >-
                      The grade the member gave for this education (LinkedIn's
                      "Grade" field, "Note" in German), as written; null when
                      none is given. On profiles with more than one language,
                      the English one, else the one in the profile's primary
                      language.
                    type:
                      - string
                      - 'null'
                  multiLocaleDegree:
                    description: >-
                      The degree in every language the member wrote it in, on
                      profiles with more than one language; absent for a single
                      language. `degree` is the English one, else the one in the
                      profile's primary language.
                    items:
                      additionalProperties: false
                      properties:
                        degree:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleDescription:
                    description: >-
                      The description in every language the member wrote it in,
                      as `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        description:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleFieldOfStudy:
                    description: >-
                      The field of study in every language the member wrote it
                      in, as `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        fieldOfStudy:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleGrade:
                    description: >-
                      The grade in every language the member wrote it in, as
                      `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        grade:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleInsights:
                    description: >-
                      The grade and the activities and societies in every
                      language the member wrote either in, as
                      `multiLocaleDegree`.
                    items:
                      additionalProperties: false
                      properties:
                        insights:
                          type: string
                        locale:
                          type: string
                      type: object
                    type: array
                  multiLocaleSchoolName:
                    description: >-
                      The school name the member wrote per language, when the
                      languages differ.
                    items:
                      additionalProperties: false
                      properties:
                        locale:
                          type: string
                        schoolName:
                          type: string
                      type: object
                    type: array
                  period:
                    type: string
                  schoolId:
                    type: string
                  schoolLinkedinUrl:
                    format: uri
                    type: string
                  schoolLogo:
                    additionalProperties: false
                    properties:
                      sizes:
                        items:
                          additionalProperties: false
                          properties:
                            height:
                              type: integer
                            url:
                              format: uri
                              type: string
                            width:
                              type: integer
                          type: object
                        type: array
                      url:
                        format: uri
                        type:
                          - string
                          - 'null'
                    type: object
                  schoolName:
                    type: string
                  skills:
                    items:
                      type: string
                    type: array
                  startDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                type: object
              type: array
            projects:
              items:
                additionalProperties: false
                properties:
                  associatedWith:
                    type: string
                  associatedWithLink:
                    format: uri
                    type:
                      - string
                      - 'null'
                  contributors:
                    items:
                      additionalProperties: false
                      properties:
                        linkedinUrl:
                          format: uri
                          type: string
                      type: object
                    type: array
                  description:
                    type: string
                  duration:
                    type: string
                  endDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  startDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  title:
                    type: string
                type: object
              type: array
            pronoun:
              description: >-
                The member's pronouns as shown on the profile, e.g. "he/him";
                null when not set.
              type:
                - string
                - 'null'
            publicIdentifier:
              type: string
            publications:
              items:
                additionalProperties: false
                properties:
                  description:
                    type:
                      - string
                      - 'null'
                  link:
                    format: uri
                    type:
                      - string
                      - 'null'
                  publishedAt:
                    type: string
                  title:
                    type: string
                type: object
              type: array
            receivedRecommendations:
              items:
                additionalProperties: false
                type: object
              type: array
            registeredAt:
              format: date-time
              type: string
            services:
              additionalProperties: false
              properties:
                description:
                  type: string
                media:
                  items:
                    additionalProperties: false
                    properties:
                      image:
                        additionalProperties: false
                        properties:
                          sizes:
                            items:
                              additionalProperties: false
                              properties:
                                height:
                                  type: integer
                                url:
                                  format: uri
                                  type: string
                                width:
                                  type: integer
                              type: object
                            type: array
                          url:
                            format: uri
                            type:
                              - string
                              - 'null'
                        type: object
                      subtitle:
                        type:
                          - string
                          - 'null'
                      title:
                        type:
                          - string
                          - 'null'
                      url:
                        format: uri
                        type: string
                    type: object
                  type: array
                rating:
                  type: string
                requestUrl:
                  format: uri
                  type: string
                servicesList:
                  items:
                    type: string
                  type: array
              type: object
            skills:
              items:
                additionalProperties: false
                properties:
                  endorsements:
                    type: string
                  name:
                    type: string
                  positions:
                    items:
                      type: string
                    type: array
                type: object
              type: array
            topSkills:
              items:
                type: string
              type: array
            verified:
              type: boolean
            volunteering:
              items:
                additionalProperties: false
                properties:
                  duration:
                    type: string
                  endDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                  organizationName:
                    type: string
                  role:
                    type: string
                  startDate:
                    additionalProperties: false
                    properties:
                      month:
                        type:
                          - string
                          - 'null'
                      text:
                        type: string
                      year:
                        type:
                          - integer
                          - 'null'
                    type: object
                type: object
              type: array
            websites:
              items:
                format: uri
                type: string
              type: array
          type:
            - object
            - 'null'
        error:
          additionalProperties: false
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
          required:
            - code
            - message
            - retryable
          type:
            - object
            - 'null'
        fulfillment:
          properties:
            field_sources:
              additionalProperties:
                items:
                  properties:
                    observation_id:
                      type: string
                    observed_at:
                      properties: {}
                      type: object
                    provider:
                      type: string
                    url:
                      type: string
                  type: object
                type: array
              type: object
            missing_fields:
              items:
                type: string
              type: array
            satisfied:
              type: boolean
          type: object
        id:
          type: string
        routing:
          additionalProperties: false
          properties:
            attempts:
              items:
                additionalProperties: false
                properties:
                  outcome:
                    enum:
                      - success
                      - partial
                      - pending
                      - error
                      - empty
                    type: string
                  provider:
                    type: string
                  requests:
                    minimum: 0
                    type: integer
                required:
                  - provider
                  - outcome
                  - requests
                type: object
              type: array
            mode:
              enum:
                - auto
                - single
                - fallback
              type: string
            selected_provider:
              type: string
          required:
            - mode
          type: object
        sources:
          items:
            additionalProperties: false
            properties:
              observation_id:
                type: string
              observed_at:
                format: date-time
                type: string
              provider:
                type: string
              url:
                type: string
            required:
              - provider
            type: object
          type: array
        status:
          enum:
            - completed
            - partial
            - not_found
            - failed
            - pending
          type: string
        tool:
          const: reverse_email
          type: string
        usage:
          additionalProperties: false
          properties:
            credit_units:
              minimum: 0
              type: integer
            credits:
              type: string
            unit:
              const: request
          required:
            - credit_units
            - credits
            - unit
          type:
            - object
            - 'null'
        version:
          const: '1'
          type: string
        warnings:
          items:
            additionalProperties: false
            properties:
              code:
                type: string
              message:
                type: string
            required:
              - code
              - message
            type: object
          type: array
      required:
        - id
        - tool
        - version
        - status
        - data
        - sources
        - usage
        - error
      type: object
    ToolError:
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      type: object
  securitySchemes:
    ApiKey:
      scheme: bearer
      type: http

````

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