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

# Profiles (async)

## Description

The **Asynchronous Professional Profile Enrichment** API provides detailed professional and workplace insights for up to **10,000** prospects in a single request. This endpoint enables deep analysis of career history, education, and workplace affiliations.

<Icon icon="thumbtack" iconType="solid" color="red" /> **Key Benefits:**

* **Retrieve bulk professional profiles** including job history, skills, and education.
* **Enhance recruiting and sales efforts** with verified workplace details.
* **Optimize segmentation and outreach** using structured career insights.

<Note>
  **Asynchronous variant.** This submits a job through the [async job infrastructure](/v2/async-jobs) — poll [job status](/v2/jobs/get_job_status) for progress and results. Input comes from an uploaded dataset (`list_id`); limits are 10,000 rows and a 24-hour run time.

  For the full output signal reference, see [the synchronous endpoint](/v2/prospects/enrichments/profiles_enrich).
</Note>

<AccordionGroup>
  <Accordion title="How It Works">
    1. **Input:** Provide up to 10,000 `prospect_id` values, obtained from the **Match Prospects** endpoint.
    2. **Processing:** The system retrieves verified professional details, including job history, education, and workplace affiliations.
    3. **Output:** Returns structured data in the same order as the input, ensuring easy mapping.
  </Accordion>

  <Accordion title="Request Schema">
    | Field     | Type   | Description                                            |
    | :-------- | :----- | :----------------------------------------------------- |
    | `list_id` | String | Identifier of an uploaded entity ID dataset (Required) |
  </Accordion>

  <Accordion title="Example Request (cURL)">
    ```shell Bash theme={null}
    curl --request POST \
         --url https://api.explorium.ai/v2/prospects/profiles/job \
         --header 'accept: application/json' \
         --header 'api_key: <your api key>' \
         --header 'content-type: application/json' \
         --data '{
      "prospect_ids": [
        "ee936e451b50c70e068e1b54e106cb89173198c4",
        "d668424ab4f6aaeeeb74248d56b8335383fd522b"
      ]
    }'
    ```
  </Accordion>

  <Accordion title="Example Response">
    ```json JSON expandable theme={null}
    {
      "response_context": {
        "correlation_id": "6f7eeca192604c73ae5b5a07671ba438",
        "request_status": "success",
        "time_took_in_seconds": 0.454
      },
      "data": [
        {
          "prospect_id": "ee936e451b50c70e068e1b54e106cb89173198c4",
          "data": {
            "full_name": "Satya Nadella",
            "country_name": "united states",
            "region_name": "washington",
            "city": "seattle",
            "linkedin": "https://linkedin.com/in/ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ",
            "experience": [
              {
                "company": {
                  "name": "university of chicago",
                  "website": "uchicago.edu"
                },
                "title": {
                  "levels": [
                    null
                  ],
                  "name": "member board of trustees"
                },
                "start_date": "2018-01",
                "is_primary": false
              },
              {
                "company": {
                  "name": "fred hutch",
                  "website": "fredhutch.org"
                },
                "title": {
                  "levels": [
                    "director"
                  ],
                  "name": "board member"
                },
                "start_date": "2016-01",
                "end_date": "2022-01"
              },
              {
                "company": {
                  "name": "microsoft",
                  "website": "microsoft.com"
                },
                "title": {
                  "levels": [
                    "cxo"
                  ],
                  "name": "chairman and chief executive officer"
                },
                "start_date": "2014-02",
                "is_primary": true
              },
              {
                "company": {
                  "name": "starbucks",
                  "website": "starbucks.com"
                },
                "title": {
                  "levels": [
                    "director"
                  ],
                  "name": "board member"
                },
                "start_date": "2017-01",
                "end_date": "2024-01"
              },
              {
                "company": {
                  "name": "the business council us",
                  "website": "thebusinesscouncil.org"
                },
                "title": {
                  "levels": [
                    "cxo"
                  ],
                  "name": "chairman"
                },
                "start_date": "2021-01",
                "end_date": "2023-01"
              }
            ],
            "skills": null,
            "interests": null,
            "age_group": "41-50",
            "education": [
              {
                "degrees": [
                  "masters degree"
                ],
                "majors": [
                  "computer science"
                ],
                "minors": [],
                "school": {
                  "name": "university of wisconsin milwaukee"
                }
              },
              {
                "start_date": "1994",
                "end_date": "1996",
                "minors": [],
                "school": {
                  "name": "the university of chicago booth school of business"
                }
              },
              {
                "degrees": [
                  "bachelors degree"
                ],
                "majors": [
                  "electrical engineering"
                ],
                "minors": [],
                "school": {
                  "name": "manipal institute of technology"
                }
              }
            ],
            "gender": "male",
            "company_name": "Microsoft",
            "company_website": "https://microsoft.com",
            "company_linkedin": "https://www.linkedin.com/company/microsoft",
            "job_department": null,
            "job_department_array": [
              "c-suite"
            ],
            "job_department_main": "c-suite",
            "job_seniority_level": "cxo",
            "job_level_array": [
              "c-suite"
            ],
            "job_level_main": "c-suite",
            "job_title": "Chairman And Chief Executive Officer",
            "linkedin_url_array": [
              "https://linkedin.com/in/acoaaaekwwab9kec2trqgoleq-vzryzecdyc6dq",
              "https://linkedin.com/in/satyanadella"
            ]
          }
        },
        {
          "prospect_id": "d668424ab4f6aaeeeb74248d56b8335383fd522b",
          "data": {
            "full_name": "Jensen Huang",
            "country_name": "united states",
            "region_name": "california",
            "city": "los altos hills",
            "linkedin": "https://linkedin.com/in/ACoAABMznFkB_XPgkYHnUl33kIHTWt1DtMAV6Pg",
            "experience": [
              {
                "company": {
                  "name": "nvidia",
                  "website": "nvidia.com"
                },
                "title": {
                  "levels": [
                    "cxo"
                  ],
                  "name": "founder and chief executive officer"
                },
                "start_date": "1993-01",
                "is_primary": true
              },
              {
                "company": {
                  "name": "dennys",
                  "website": "dennys.com"
                },
                "title": {
                  "levels": [
                    null
                  ],
                  "name": "dishwasher, busboy, waiter"
                },
                "start_date": "1978-01",
                "end_date": "1983-01"
              }
            ],
            "skills": [
              "management"
            ],
            "interests": null,
            "age_group": "61-70",
            "education": [
              {
                "degrees": [
                  "bsee"
                ],
                "start_date": "1980",
                "end_date": "1984",
                "minors": [],
                "school": {}
              },
              {
                "degrees": [
                  "msee"
                ],
                "start_date": "1990",
                "end_date": "1992",
                "minors": [],
                "school": {}
              }
            ],
            "gender": "male",
            "company_name": "Nvidia",
            "company_website": "https://nvidia.com",
            "company_linkedin": "https://www.linkedin.com/company/nvidia",
            "job_department": null,
            "job_department_array": [
              "c-suite"
            ],
            "job_department_main": "c-suite",
            "job_seniority_level": "cxo",
            "job_level_array": [
              "c-suite",
              "founder"
            ],
            "job_level_main": "c-suite",
            "job_title": "Founder And Chief Executive Officer",
            "linkedin_url_array": [
              "https://linkedin.com/in/acoaabmznfkb_xpgkyhnul33kihtwt1dtmav6pg",
              "https://linkedin.com/in/jenhsunhuang"
            ]
          }
        }
      ],
      "total_results": 2
    }
    ```
  </Accordion>

  <Accordion title="Best Practices">
    * **Ensure valid prospect IDs** to maximize data accuracy.
    * **Use enriched profiles** to refine candidate selection and outreach.
    * **Monitor career movements** to track professional growth trends.
    * **Leverage structured education and skills data** for talent and partnership analysis.
  </Accordion>

  <Accordion title="Asynchronous Professional Profile Output Signals">
    | Signal                 | API Name                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                         | Data Type Final |
    | :--------------------- | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------- |
    | gender                 | Individual's gender                           | Gender reported by the individual on their profile. If gender is not reported on profile, returned value is 'null'.                                                                                                                                                                                                                                                                                                                                 | string          |
    | city                   | Individual's city of residence                | Individual's city of residence reported on profile.                                                                                                                                                                                                                                                                                                                                                                                                 | string          |
    | country\_name          | Individual's country of residence             | Individual's country of residence reported on profile.                                                                                                                                                                                                                                                                                                                                                                                              | string          |
    | region\_name           | Individual's State / Region of residence      | Individual's state or region of residence reported on profile.                                                                                                                                                                                                                                                                                                                                                                                      | string          |
    | company\_website       | Individual's workplace: company website       | URL to the company website belonging to the individual's workplace.                                                                                                                                                                                                                                                                                                                                                                                 | string          |
    | company\_linkedin      | Individual's workplace: company LinkedIn® url | URL to the company LinkedIn® page belonging to the individual's workplace.                                                                                                                                                                                                                                                                                                                                                                          | string          |
    | linkedin               | Individual's LinkedIn® URL                    | URL of the individual's LinkedIn® profile.                                                                                                                                                                                                                                                                                                                                                                                                          | url             |
    | linkedin\_url\_array   | LinkedIn®  Identifier Array                   | A list of LinkedIn® profile URLs associated with the prospect. Each entry may include a standard public URL and/or a URN-based URL.                                                                                                                                                                                                                                                                                                                 | array\[string]  |
    | age\_group             | Individual's age group                        | Individual's estimated age group.                                                                                                                                                                                                                                                                                                                                                                                                                   | string          |
    | experience             | Individual's work experience background       | List of work experience background entries on the individual's profile. May include: company name, company website, job title, seniority level, role, start date, end date, and more. Includes current work experience activities if listed.                                                                                                                                                                                                        | array           |
    | education              | Individual's educational background           | List of educational background entries on the individual's profile. May include: institutions name, institutions website, degree category, major, start date, end date, and more. Includes current educational activities if listed.                                                                                                                                                                                                                | array           |
    | interests              | Individual's interests                        | List of all interests reported by the individual on their profile.                                                                                                                                                                                                                                                                                                                                                                                  | array           |
    | skills                 | Individual's skills                           | List of all skills reported by the individual on their profile.                                                                                                                                                                                                                                                                                                                                                                                     | array           |
    | job\_title             | Individual's job title                        | Individual's current job title listed on their professional profile.                                                                                                                                                                                                                                                                                                                                                                                | string          |
    | job\_department        | Individual's job department                   | Individual's job department, derived from their current job title.                                                                                                                                                                                                                                                                                                                                                                                  | object          |
    | job\_department\_array | Job Department (Array)                        | All detected normalized job departments for the individual. Examples: retail, engineering, customer success, administration, education, security, healthcare, public service, partnerships, creative, strategy, real estate, procurement, IT, data, c-suite, manufacturing, support, logistics, product, sales, design, marketing, finance, R\&D, trade, human resources, legal, operations.                                                        | array\<string>  |
    | job\_department\_main  | Job Department (Main)                         | Primary normalized job department selected from the detected departments (e.g., “engineering”). Examples of possible values: retail, engineering, customer success, administration, education, security, healthcare, public service, partnerships, creative, strategy, real estate, procurement, IT, data, c-suite, manufacturing, support, logistics, product, sales, design, marketing, finance, R\&D, trade, human resources, legal, operations. | string          |
    | job\_seniority\_level  | Individual's seniority level                  | Individual's top seniority level, derived from their current job title.                                                                                                                                                                                                                                                                                                                                                                             | object          |
    | job\_level\_array      | Job Level (Array)                             | All detected normalized job levels for the individual. Examples: manager, president, senior manager, owner, advisor, freelancer, junior, director, c-suite, board member, senior non-managerial, non-managerial, partner, vice president, founder.                                                                                                                                                                                                  | array\<string>  |
    | job\_level\_main       | Job Level (Main)                              | Primary normalized job level selected from the detected levels (e.g., “senior non-managerial”). Examples of possible values: manager, president, senior manager, owner, advisor, freelancer, junior, director, c-suite, board member, senior non-managerial, non-managerial, partner, vice president, founder.                                                                                                                                      | string          |
    | company\_name          | Individual's workplace: company name          | Name of the company the individual listed as their workplace.                                                                                                                                                                                                                                                                                                                                                                                       | string          |
    | full\_name             | Individual's full name                        | First and last names associated with the individual, appended with a space.                                                                                                                                                                                                                                                                                                                                                                         | string          |
  </Accordion>
</AccordionGroup>

## Body Params - Try Me Example

```
prospect_ids: ee936e451b50c70e068e1b54e106cb89173198c4,
  57f9e5dac64d31d80e6e9432fe2c500d0bba2c01
```


## OpenAPI

````yaml post /v2/prospects/profiles/job
openapi: 3.1.0
info:
  title: Partner Service
  version: 0.3.18
servers:
  - url: https://api.explorium.ai
    description: AgentSource Server
security: []
paths:
  /v2/prospects/profiles/job:
    post:
      tags:
        - AsyncEnrichmentJobs
      summary: Prospects Profiles Job
      operationId: v2_prospects_profiles_job
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AsyncProspectsProfilesJobSubmitRequest'
        required: true
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2AsyncEnrichmentJobSubmitResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - APIKeyHeader: []
components:
  schemas:
    AsyncProspectsProfilesJobSubmitRequest:
      properties:
        list_id:
          type: string
          title: List Id
          description: Entity ID list identifier returned by the upload endpoint
      type: object
      required:
        - list_id
      title: AsyncProspectsProfilesJobSubmitRequest
    V2AsyncEnrichmentJobSubmitResponse:
      properties:
        job_id:
          type: string
          title: Job Id
        status:
          type: string
          title: Status
        status_url:
          type: string
          title: Status Url
      type: object
      required:
        - job_id
        - status
        - status_url
      title: V2AsyncEnrichmentJobSubmitResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: api_key

````