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

# Get Deep Research Status

> Check the status and results of a deep research job with optional pagination

Check the status of a deep research job and retrieve results when the job is completed. Supports optional pagination for managing large result sets.

> **🚨 DEPRECATION NOTICE**: The legacy response format will be deprecated on **November 1st, 2025**. The `legacy` parameter currently defaults to `true` but will be removed. Please migrate to the modern format by setting `legacy=false`. See [https://docs.clado.ai/api-reference/changelog](https://docs.clado.ai/api-reference/changelog) for migration details.

## Get Deep Research Status

### Without Pagination (All Results)

```bash theme={null}
curl -X GET https://search.clado.ai/api/search/deep_research/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### With Pagination

```bash theme={null}
# Get first page with 25 results (default page size)
curl -X GET "https://search.clado.ai/api/search/deep_research/550e8400-e29b-41d4-a716-446655440000?page=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get second page with custom page size
curl -X GET "https://search.clado.ai/api/search/deep_research/550e8400-e29b-41d4-a716-446655440000?page=2&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Path Parameters

| Parameter | Type   | Required | Description                                       |
| --------- | ------ | -------- | ------------------------------------------------- |
| job\_id   | string | Yes      | The job ID returned from initiating deep research |

### Query Parameters

| Parameter  | Type    | Required | Description                                                                                         |
| ---------- | ------- | -------- | --------------------------------------------------------------------------------------------------- |
| page       | integer | No       | Page number (1-indexed). If not provided, returns all results without pagination                    |
| page\_size | integer | No       | Number of results per page (1-100, default: 25). Only applies when page parameter is provided       |
| legacy     | boolean | No       | **DEPRECATED**: Return results in legacy format (default: true). Will be removed November 1st, 2025 |

### Response (Pending)

```json theme={null}
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Deep research job is still processing"
}
```

### Response (Completed - Without Pagination)

When no `page` parameter is provided, all results are returned:

```json theme={null}
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "message": "Deep research completed with 47 validated profiles",
  "created_at": 1706266200,
  "opensearch_results": 150,
  "final_results_count": 47,
  "total_filtered": 47,
  "search_chunk_done": 5,
  "search_chunk_total": 5,
  "results": [
    {
      "profile": {
        "id": "103901716",
        "name": "Alex Johnson",
        "location": "San Francisco, California, United States",
        "location_country": "United States",
        "location_regions": ["Americas", "Northern America", "AMER"],
        "headline": "Principal Engineer at TechCorp Inc",
        "description": "Machine Learning Engineer at TechCorp. Previously at StartupCo and InnovateTech. Expert in distributed systems and AI infrastructure.",
        "linkedin_url": "https://www.linkedin.com/in/alexjohnson",
        "picture_permalink": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
        "connections_count": 500,
        "followers_count": 9497,
        "is_working": true,
        "is_decision_maker": false,
        "total_experience_duration_months": 234,
        "projected_total_salary": 285000.0,
        "post_count": 12,
        "posts": "Excited to share our latest ML research on distributed training optimization. Working on next-gen AI infrastructure at TechCorp.",
        "liked_posts": "Three ways to create efficient ML pipelines. Here's a potential breakthrough in self-training AI systems. Excited about the future of distributed computing.",
        "recommendations": "Alex is an exceptional engineer with deep expertise in machine learning infrastructure. His work on distributed systems has been instrumental to our team's success.",
        "recommendations_count": 8,
        "skills": ["Machine Learning", "Python", "Distributed Systems", "PyTorch", "Kubernetes", "AI Infrastructure"]
      },
      "experience": [
        {
          "title": "Principal Engineer",
          "company_name": "TechCorp Inc",
          "start_date": "2022-03-01T00:00:00",
          "end_date": "1970-01-01T00:00:00",
          "description": "Leading ML infrastructure team, developing scalable AI systems for production deployment",
          "location": "San Francisco, CA"
        },
        {
          "title": "Senior Software Engineer",
          "company_name": "StartupCo",
          "start_date": "2019-06-01T00:00:00",
          "end_date": "2022-02-28T00:00:00",
          "description": "Built distributed training systems and ML pipelines",
          "location": "Palo Alto, CA"
        }
      ],
      "education": [
        {
          "degree": "Master of Science",
          "field_of_study": "Computer Science",
          "school_name": "State University",
          "start_date": "2017-09-01T00:00:00",
          "end_date": "2019-06-01T00:00:00"
        },
        {
          "degree": "Bachelor of Science",
          "field_of_study": "Computer Engineering",
          "school_name": "Tech Institute",
          "start_date": "2013-09-01T00:00:00",
          "end_date": "2017-06-01T00:00:00"
        }
      ],
      "posts": [
        {
          "text": "Excited to share our latest ML research on distributed training optimization",
          "totalReactionCount": 156,
          "likeCount": 89,
          "appreciationCount": 23,
          "empathyCount": 18,
          "InterestCount": 12,
          "praiseCount": 10,
          "commentsCount": 24,
          "repostsCount": 8,
          "postUrl": "https://www.linkedin.com/posts/alexjohnson_ml-research-activity-7150123456789",
          "postedAt": "2 days ago",
          "postedDate": "2024-01-26T10:30:00Z",
          "postedDateTimestamp": 1706266200,
          "reposted": false,
          "urn": "urn:li:activity:7150123456789",
          "author": {
            "firstName": "Alex",
            "lastName": "Johnson",
            "username": "alexjohnson",
            "url": "https://www.linkedin.com/in/alexjohnson"
          },
          "mentions": [],
          "companyMentions": [
            {
              "id": 12345,
              "name": "TechCorp Inc",
              "publicIdentifier": "techcorp-inc",
              "url": "https://www.linkedin.com/company/techcorp-inc"
            }
          ],
          "isBrandPartnership": false
        }
      ]
    },
    {
      "profile": {
        "id": "203901717",
        "name": "Sarah Wilson",
        "location": "New York, New York, United States",
        "location_country": "United States",
        "location_regions": ["Americas", "Northern America", "AMER"],
        "headline": "Senior Data Scientist at InnovateTech",
        "description": "Data Science leader with 8+ years experience in ML and analytics. Passionate about AI ethics and responsible ML deployment.",
        "linkedin_url": "https://www.linkedin.com/in/sarahwilson",
        "connections_count": 750,
        "followers_count": 3200,
        "is_working": true,
        "is_decision_maker": true,
        "total_experience_duration_months": 96,
        "projected_total_salary": 195000.0,
        "post_count": 8,
        "skills": ["Data Science", "Machine Learning", "Python", "R", "Statistics", "AI Ethics"]
      },
      "experience": [
        {
          "title": "Senior Data Scientist",
          "company_name": "InnovateTech",
          "start_date": "2021-01-01T00:00:00",
          "end_date": "1970-01-01T00:00:00",
          "description": "Leading data science initiatives and ML model development",
          "location": "New York, NY"
        }
      ],
      "education": [
        {
          "degree": "PhD",
          "field_of_study": "Statistics",
          "school_name": "Research University",
          "start_date": "2015-09-01T00:00:00",
          "end_date": "2019-12-01T00:00:00"
        }
      ]
    }
  ]
}
```

### Response (Completed - With Pagination)

When `page` parameter is provided, results are paginated:

```json theme={null}
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "message": "Deep research completed with 47 validated profiles",
  "created_at": 1706266200,
  "opensearch_results": 150,
  "final_results_count": 47,
  "total_filtered": 47,
  "search_chunk_done": 5,
  "search_chunk_total": 5,
  "results": [
    {
      "profile": {
        "id": "103901716",
        "name": "Alex Johnson",
        "location": "San Francisco, California, United States",
        "headline": "Principal Engineer at TechCorp Inc",
        "linkedin_url": "https://www.linkedin.com/in/alexjohnson"
      }
    }
    // ... 24 more results for this page
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_pages": 2,
    "total_results": 47,
    "has_next": true,
    "has_previous": false
  }
}
```

## Status Values

| Status     | Description                                     |
| ---------- | ----------------------------------------------- |
| pending    | Job is queued and waiting to start              |
| searching  | Job is actively searching for profiles          |
| processing | Job is validating and processing found profiles |
| completed  | Job finished successfully with results          |
| error      | Job encountered an error                        |
| cancelled  | Job was cancelled by user                       |

## Error Responses

| Status Code | Description                                                                              |
| ----------- | ---------------------------------------------------------------------------------------- |
| 400         | Bad Request - Invalid pagination parameters (e.g., page \< 1 or page\_size out of range) |
| 401         | Unauthorized - API key missing or invalid                                                |
| 403         | Forbidden - Not authorized to access this job                                            |
| 404         | Not Found - Job ID does not exist                                                        |

## Pagination Notes

* **Optional pagination**: If no `page` parameter is provided, all results are returned (backward compatible)
* **Page numbering**: Pages are 1-indexed (first page is page 1)
* **Page size**: Default is 25 results per page, can be customized from 1 to 100
* **Efficient browsing**: Use pagination to efficiently browse through large result sets
* **Pagination metadata**: The `pagination` object is only included in responses when the `page` parameter is provided

## General Notes

* This endpoint is **free** - no credits are consumed for checking status
* Poll this endpoint periodically to check job progress
* Results will become available gradually as the search is running
* Jobs typically complete within 2-15 minutes depending on query complexity
* The `final_results_count` field shows the total number of validated profiles across all pages


## OpenAPI

````yaml GET /api/search/deep_research/{job_id}
openapi: 3.1.0
info:
  title: Clado Search & Enrichment API
  description: API for searching LinkedIn profiles and enriching contact information
  version: 1.0.0
servers:
  - url: https://search.clado.ai
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/search/deep_research/{job_id}:
    get:
      tags:
        - Deep Research
      summary: Get Deep Research Status
      description: >-
        Get the status and results of a deep research job with optional
        pagination. If page parameter is not provided, returns all results
        without pagination.
      operationId: getDeepResearchStatus
      parameters:
        - name: job_id
          in: path
          required: true
          description: >-
            Unique identifier for the deep research job (returned from POST
            /api/search/deep_research)
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: >-
            Page number (1-indexed). If not provided, returns all results
            without pagination
          schema:
            type: integer
            minimum: 1
        - name: page_size
          in: query
          required: false
          description: >-
            Number of results per page when pagination is used. Only applies
            when page parameter is provided
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
        - name: legacy
          in: query
          required: false
          description: >-
            DEPRECATED: Return results in legacy format (default: true). Will be
            removed November 1st, 2025
          schema:
            type: boolean
            default: true
      responses:
        '200':
          description: Job status and results (paginated if page parameter is provided)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeepResearchStatusResponse'
        '400':
          description: Bad Request - Invalid pagination parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Page number must be >= 1
        '401':
          description: Unauthorized - API key missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - Not authorized to access this job
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found - Job not found in Redis or Supabase
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    DeepResearchStatusResponse:
      type: object
      properties:
        job_id:
          type: string
          description: Unique job identifier
        status:
          type: string
          description: >-
            Job status (pending, searching, processing, completed, error,
            cancelled)
        message:
          type: string
          description: Status message
        created_at:
          type: number
          description: Unix timestamp of when the job was created
        opensearch_results:
          type: integer
          description: Number of results found in OpenSearch
        final_results_count:
          type: integer
          description: Total number of validated profiles across all pages
        total_filtered:
          type: integer
          description: Number of filtered results
        search_chunk_done:
          type: integer
          description: Number of search chunks processed
        search_chunk_total:
          type: integer
          description: Total number of search chunks
        results:
          type: array
          items:
            $ref: '#/components/schemas/UserResult'
          description: Array of user profiles (paginated if page parameter is provided)
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
          description: >-
            Pagination information (only present when page parameter is
            provided)
        error:
          type: string
          description: Error details (only present when status is 'error')
      example:
        job_id: 550e8400-e29b-41d4-a716-446655440000
        status: completed
        message: Deep research completed successfully
        total_results: 47
        results:
          - profile:
              id: '103901716'
              name: Alex Johnson
              location: San Francisco, California, United States
              location_country: United States
              location_regions:
                - Americas
                - Northern America
                - AMER
              headline: Principal Engineer at TechCorp Inc
              description: >-
                Machine Learning Engineer at TechCorp. Previously at StartupCo
                and InnovateTech. Expert in distributed systems and AI
                infrastructure.
              linkedin_url: https://www.linkedin.com/in/alexjohnson
              picture_permalink: https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2
              connections_count: 500
              followers_count: 9497
              is_working: true
              is_decision_maker: false
              total_experience_duration_months: 234
              projected_total_salary: 285000
              post_count: 12
              posts: >-
                Excited to share our latest ML research on distributed training
                optimization. Working on next-gen AI infrastructure at TechCorp.
              liked_posts: >-
                Three ways to create efficient ML pipelines. Here's a potential
                breakthrough in self-training AI systems. Excited about the
                future of distributed computing.
              recommendations: >-
                Alex is an exceptional engineer with deep expertise in machine
                learning infrastructure. His work on distributed systems has
                been instrumental to our team's success.
              recommendations_count: 8
              skills:
                - Machine Learning
                - Python
                - Distributed Systems
                - PyTorch
                - Kubernetes
                - AI Infrastructure
            experience:
              - title: Principal Engineer
                company_name: TechCorp Inc
                start_date: '2022-03-01T00:00:00'
                end_date: '1970-01-01T00:00:00'
                description: >-
                  Leading ML infrastructure team, developing scalable AI systems
                  for production deployment
                location: San Francisco, CA
            education:
              - degree: Master of Science
                field_of_study: Computer Science
                school_name: State University
                start_date: '2017-09-01T00:00:00'
                end_date: '2019-06-01T00:00:00'
            posts:
              - text: >-
                  Excited to share our latest ML research on distributed
                  training optimization
                totalReactionCount: 156
                likeCount: 89
                appreciationCount: 23
                empathyCount: 18
                InterestCount: 12
                praiseCount: 10
                commentsCount: 24
                repostsCount: 8
                postUrl: >-
                  https://www.linkedin.com/posts/alexjohnson_ml-research-activity-7150123456789
                postedAt: 2 days ago
                postedDate: '2024-01-26T10:30:00Z'
                postedDateTimestamp: 1706266200
                reposted: false
                urn: urn:li:activity:7150123456789
                author:
                  firstName: Alex
                  lastName: Johnson
                  username: alexjohnson
                  url: https://www.linkedin.com/in/alexjohnson
                mentions: []
                companyMentions:
                  - id: 12345
                    name: TechCorp Inc
                    publicIdentifier: techcorp-inc
                    url: https://www.linkedin.com/company/techcorp-inc
                isBrandPartnership: false
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Error message
      required:
        - detail
    UserResult:
      type: object
      properties:
        profile:
          $ref: '#/components/schemas/UserProfile'
        experience:
          type: array
          items:
            $ref: '#/components/schemas/Experience'
          description: Work experience history
        education:
          type: array
          items:
            $ref: '#/components/schemas/Education'
          description: Educational background
        posts:
          type: array
          items:
            $ref: '#/components/schemas/Post'
          description: Recent LinkedIn posts and activity
        awards:
          type: array
          items:
            $ref: '#/components/schemas/Award'
          description: Awards and honors received
        certifications:
          type: array
          items:
            $ref: '#/components/schemas/Certification'
          description: Professional certifications
        organizations:
          type: array
          items:
            $ref: '#/components/schemas/Organization'
          description: Organizations and associations
        patents:
          type: array
          items:
            $ref: '#/components/schemas/Patent'
          description: Patents filed or granted
        projects:
          type: array
          items:
            $ref: '#/components/schemas/Project'
          description: Professional projects
        publications:
          type: array
          items:
            $ref: '#/components/schemas/Publication'
          description: Published works and articles
        github_repos:
          type: array
          items:
            $ref: '#/components/schemas/GitHubRepo'
          description: GitHub repositories
    PaginationInfo:
      type: object
      properties:
        page:
          type: integer
          description: Current page number
        page_size:
          type: integer
          description: Number of results per page
        total_pages:
          type: integer
          description: Total number of pages
        total_results:
          type: integer
          description: Total number of results across all pages
        has_next:
          type: boolean
          description: Whether there is a next page
        has_previous:
          type: boolean
          description: Whether there is a previous page
      required:
        - page
        - page_size
        - total_pages
        - total_results
        - has_next
        - has_previous
    UserProfile:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the profile
        name:
          type: string
          description: Full name of the person
        location:
          type: string
          description: Geographic location
        location_country:
          type: string
          description: Country of location
        location_regions:
          type: array
          items:
            type: string
          description: Geographic regions (e.g., Americas, Northern America, AMER)
        headline:
          type: string
          description: Professional headline or current position
        description:
          type: string
          description: About section or professional summary
        linkedin_url:
          type: string
          description: LinkedIn profile URL
        picture_permalink:
          type: string
          description: Profile picture URL
        connections_count:
          type: integer
          description: Number of LinkedIn connections
        followers_count:
          type: integer
          description: Number of LinkedIn followers
        is_working:
          type: boolean
          description: Whether the person is currently working
        is_decision_maker:
          type: boolean
          description: Whether the person is identified as a decision maker
        total_experience_duration_months:
          type: integer
          description: Total work experience in months
        projected_total_salary:
          type: number
          description: Estimated total salary
        post_count:
          type: integer
          description: Number of LinkedIn posts
        posts:
          type: string
          description: Recent posts content
        liked_posts:
          type: string
          description: Content of posts the user has liked
        recommendations:
          type: string
          description: LinkedIn recommendations
        recommendations_count:
          type: integer
          description: Number of recommendations
        skills:
          type: array
          items:
            type: string
          description: Professional skills
    Experience:
      type: object
      properties:
        title:
          type: string
          description: Job title
        company_name:
          type: string
          description: Company name
        start_date:
          type: string
          description: Start date in ISO format
        end_date:
          type: string
          description: End date in ISO format (1970-01-01T00:00:00 for current)
        description:
          type: string
          description: Job description
        location:
          type: string
          description: Work location
    Education:
      type: object
      properties:
        degree:
          type: string
          description: Degree type
        field_of_study:
          type: string
          description: Field of study
        school_name:
          type: string
          description: School or university name
        start_date:
          type: string
          description: Start date in ISO format
        end_date:
          type: string
          description: End date in ISO format
    Post:
      type: object
      properties:
        text:
          type: string
          description: Post content text
        totalReactionCount:
          type: integer
          description: Total number of reactions
        likeCount:
          type: integer
          description: Number of like reactions
        appreciationCount:
          type: integer
          description: Number of appreciation reactions
        empathyCount:
          type: integer
          description: Number of empathy reactions
        InterestCount:
          type: integer
          description: Number of interest reactions
        praiseCount:
          type: integer
          description: Number of praise reactions
        commentsCount:
          type: integer
          description: Number of comments
        repostsCount:
          type: integer
          description: Number of reposts
        postUrl:
          type: string
          description: URL to the LinkedIn post
        postedAt:
          type: string
          description: Human-readable time since posted
        postedDate:
          type: string
          description: ISO timestamp of when posted
        postedDateTimestamp:
          type: integer
          description: Unix timestamp of when posted
        reposted:
          type: boolean
          description: Whether this is a repost
        urn:
          type: string
          description: LinkedIn URN identifier
        author:
          $ref: '#/components/schemas/PostAuthor'
        image:
          type: array
          items:
            $ref: '#/components/schemas/PostImage'
          description: Post images
        video:
          type: array
          items:
            $ref: '#/components/schemas/PostVideo'
          description: Post videos
        mentions:
          type: array
          items:
            $ref: '#/components/schemas/PostMention'
          description: People mentioned in the post
        companyMentions:
          type: array
          items:
            $ref: '#/components/schemas/CompanyMention'
          description: Companies mentioned in the post
        isBrandPartnership:
          type: boolean
          description: Whether this is a brand partnership post
    Award:
      type: object
      properties:
        title:
          type: string
          description: Award title
        issuer:
          type: string
          description: Organization that issued the award
        description:
          type: string
          description: Award description
        date_year:
          type: integer
          description: Year the award was received
        date_month:
          type: integer
          description: Month the award was received
        order_in_profile:
          type: integer
          description: Display order in profile
    Certification:
      type: object
      properties:
        title:
          type: string
          description: Certification title
        issuer:
          type: string
          description: Issuing organization
        date_from_year:
          type: integer
          description: Year certification was obtained
        date_from_month:
          type: integer
          description: Month certification was obtained
        date_to_year:
          type: integer
          description: Year certification expires
        date_to_month:
          type: integer
          description: Month certification expires
    Organization:
      type: object
      properties:
        organization_name:
          type: string
          description: Name of the organization
        position:
          type: string
          description: Position held in the organization
        description:
          type: string
          description: Description of role or involvement
        date_from_year:
          type: integer
          description: Start year
        date_from_month:
          type: integer
          description: Start month
        date_to_year:
          type: integer
          description: End year
        date_to_month:
          type: integer
          description: End month
    Patent:
      type: object
      properties:
        title:
          type: string
          description: Patent title
        description:
          type: string
          description: Patent description
        status:
          type: string
          description: Patent status (pending, granted, etc.)
        date_year:
          type: integer
          description: Year of patent filing/grant
        date_month:
          type: integer
          description: Month of patent filing/grant
    Project:
      type: object
      properties:
        name:
          type: string
          description: Project name
        description:
          type: string
          description: Project description
        date_from_year:
          type: integer
          description: Project start year
        date_from_month:
          type: integer
          description: Project start month
        date_to_year:
          type: integer
          description: Project end year
        date_to_month:
          type: integer
          description: Project end month
    Publication:
      type: object
      properties:
        title:
          type: string
          description: Publication title
        description:
          type: string
          description: Publication description or abstract
        publisher_names:
          type: string
          description: Publisher or journal name
        date_year:
          type: integer
          description: Publication year
        date_month:
          type: integer
          description: Publication month
    GitHubRepo:
      type: object
      properties:
        name:
          type: string
          description: Repository name
        summary:
          type: string
          description: Repository description
        stars:
          type: integer
          description: Number of stars
        contributions_count:
          type: integer
          description: Number of contributions
    PostAuthor:
      type: object
      properties:
        firstName:
          type: string
          description: Author's first name
        lastName:
          type: string
          description: Author's last name
        username:
          type: string
          description: LinkedIn username
        url:
          type: string
          description: LinkedIn profile URL
    PostImage:
      type: object
      properties:
        url:
          type: string
          description: Image URL
        width:
          type: integer
          description: Image width in pixels
        height:
          type: integer
          description: Image height in pixels
    PostVideo:
      type: object
      properties:
        url:
          type: string
          description: Video URL
        width:
          type: integer
          description: Video width in pixels
        height:
          type: integer
          description: Video height in pixels
    PostMention:
      type: object
      properties:
        firstName:
          type: string
          description: Mentioned person's first name
        lastName:
          type: string
          description: Mentioned person's last name
        urn:
          type: string
          description: LinkedIn URN
        publicIdentifier:
          type: string
          description: LinkedIn public identifier
    CompanyMention:
      type: object
      properties:
        id:
          type: integer
          description: Company ID
        name:
          type: string
          description: Company name
        publicIdentifier:
          type: string
          description: Company LinkedIn identifier
        url:
          type: string
          description: Company LinkedIn URL
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Keys start with 'lk_'.

````