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

# Demo decision makers (public, no key)

> Decision makers for a demo-eligible company — same shape as `/company/{id}/dm`, but public and
scoped to the rolling demo set (recently searched + 1..MAX_DM DMs). 404 for anything outside it.



## OpenAPI

````yaml https://api.bossradar.com/openapi.json get /v1/demo/company/{company_id}/dm
openapi: 3.1.0
info:
  title: bossradar API
  description: >

    Give bossradar a **LinkedIn company** — get back its **decision makers**.


    You submit a company (URL, slug, numeric id, or name); we resolve it,
    harvest the roster,

    classify who actually decides, enrich the shortlist, and return a ranked
    verdict. Jobs run

    **asynchronously** (minutes) — you either poll `GET /v1/jobs/{id}` or
    receive a **webhook**.


    All endpoints are versioned under **`/v1`**. Pin the version; new fields are
    added within `/v1`,

    breaking changes ship under a new `/vN`.


    ### Authentication

    Every request needs an API key in the `X-API-Key` header. Generate yours in
    the

    [dashboard](https://app.bossradar.com/dashboard) (`brk_live_…`). `POST
    /v1/jobs` spends money, so it

    is never anonymous.


    ### The flow — two calls

    1. `POST /v1/jobs` `{ "input": "linkedin.com/company/<slug>" }` → `202 {
    job_id }`

    2. Poll `GET /v1/jobs/{job_id}` until `status: "done"` — that response
    already **contains the decision
       makers inline** (`company` + `decision_maker_count` + `decision_makers[]`). No third call.

    Re-polling a finished job returns the same result (idempotent, already paid
    for), so a lost response

    never costs a new job.


    ### Webhook (optional — instead of polling)

    Pass `callback_url` on `POST /v1/jobs`. When the job is done we `POST` that
    URL with the full result:

    `{ job_id, company_id, company, status: "done", decision_maker_count,
    decision_makers[] }`. You just need

    an HTTPS endpoint on your side that returns `2xx`.
  contact:
    name: bossradar
    url: https://app.bossradar.com/
    email: admin@bossradar.com
  version: 1.0.0
servers:
  - url: https://api.bossradar.com
    description: Production
security: []
tags:
  - name: jobs
    description: Submit and track decision-maker jobs.
  - name: demo
    description: Public, login-free showcase over recently-searched companies.
paths:
  /v1/demo/company/{company_id}/dm:
    get:
      tags:
        - demo
      summary: Demo decision makers (public, no key)
      description: >-
        Decision makers for a demo-eligible company — same shape as
        `/company/{id}/dm`, but public and

        scoped to the rolling demo set (recently searched + 1..MAX_DM DMs). 404
        for anything outside it.
      operationId: demo_company_dm_v1_demo_company__company_id__dm_get
      parameters:
        - name: company_id
          in: path
          required: true
          schema:
            type: integer
            title: Company Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DMResponse'
        '404':
          description: Not in the current demo set.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    DMResponse:
      properties:
        company_id:
          type: integer
          title: Company Id
          examples:
            - 3384253
        company:
          anyOf:
            - $ref: '#/components/schemas/Company'
            - type: 'null'
          description: >-
            The company these decision makers work at — one shared context for
            the whole response, not repeated per person.
        decision_maker_count:
          type: integer
          title: Decision Maker Count
          examples:
            - 5
        decision_makers:
          items:
            $ref: '#/components/schemas/DecisionMaker'
          type: array
          title: Decision Makers
          description: >-
            Confirmed decision makers, ranked (rank_in_company ascending, 1
            first).
      type: object
      required:
        - company_id
        - decision_maker_count
        - decision_makers
      title: DMResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Company:
      properties:
        id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Id
          examples:
            - 3384253
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        linkedin_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin Url
        website:
          anyOf:
            - type: string
            - type: 'null'
          title: Website
        domain:
          anyOf:
            - type: string
            - type: 'null'
          title: Domain
        industry:
          anyOf:
            - type: string
            - type: 'null'
          title: Industry
        type:
          anyOf:
            - type: string
            - type: 'null'
          title: Type
          examples:
            - Privately Held
        employees_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Employees Count
        linkedin_since_est:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin Since Est
          description: >-
            Estimated LinkedIn-since (computed from company_id): 'YYYY-MM' |
            'YYYY-Qn' | 'YYYY' | 'before 2022'.
          examples:
            - 2023-11
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        slogan:
          anyOf:
            - type: string
            - type: 'null'
          title: Slogan
        specialties:
          items:
            type: string
          type: array
          title: Specialties
          description: Self-declared focus/tech areas (Page-admin free text).
        location:
          $ref: '#/components/schemas/CompanyLocation'
        followers:
          anyOf:
            - type: integer
            - type: 'null'
          title: Followers
        last_post_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Post Date
        content_language:
          anyOf:
            - type: string
            - type: 'null'
          title: Content Language
          description: >-
            ISO 639-1 code of the company's public language (from
            description/slogan/posts).
          examples:
            - en
        hiring_for:
          items:
            type: string
          type: array
          title: Hiring For
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
        has_logo:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Logo
        recent_posts:
          items:
            $ref: '#/components/schemas/CompanyPost'
          type: array
          title: Recent Posts
      type: object
      title: Company
    DecisionMaker:
      properties:
        rank_in_company:
          anyOf:
            - type: integer
            - type: 'null'
          title: Rank In Company
          description: 1 = contact first.
          examples:
            - 1
        is_decision_maker:
          type: boolean
          title: Is Decision Maker
          description: Always true in this response — non-DMs are filtered out.
          default: true
        person:
          $ref: '#/components/schemas/Person'
        verdict:
          $ref: '#/components/schemas/VerdictCore'
        contact:
          $ref: '#/components/schemas/Contact'
        experience:
          items:
            $ref: '#/components/schemas/ExperienceItem'
          type: array
          title: Experience
        education:
          items:
            $ref: '#/components/schemas/EducationItem'
          type: array
          title: Education
        signals:
          $ref: '#/components/schemas/Signals'
        meta:
          $ref: '#/components/schemas/Meta'
      type: object
      title: DecisionMaker
    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
    CompanyLocation:
      properties:
        locality:
          anyOf:
            - type: string
            - type: 'null'
          title: Locality
        region:
          anyOf:
            - type: string
            - type: 'null'
          title: Region
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Postal Code
      type: object
      title: CompanyLocation
    CompanyPost:
      properties:
        content:
          anyOf:
            - type: string
            - type: 'null'
          title: Content
        posted_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Posted At
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
      type: object
      title: CompanyPost
    Person:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          examples:
            - Jane Doe
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          title: First Name
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Name
        headline:
          anyOf:
            - type: string
            - type: 'null'
          title: Headline
        linkedin_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin Url
          examples:
            - https://www.linkedin.com/in/jane-doe
        photo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Photo Url
        location:
          $ref: '#/components/schemas/PersonLocation'
        about:
          anyOf:
            - type: string
            - type: 'null'
          title: About
        connections:
          anyOf:
            - type: integer
            - type: 'null'
          title: Connections
        followers:
          anyOf:
            - type: integer
            - type: 'null'
          title: Followers
        member_since:
          anyOf:
            - type: string
            - type: 'null'
          title: Member Since
          description: Exact LinkedIn account registration date (ISO YYYY-MM-DD).
          examples:
            - '2011-07-27'
        content_language:
          anyOf:
            - type: string
            - type: 'null'
          title: Content Language
          description: >-
            ISO 639-1 code of the language the person writes in (from their
            posts/about).
          examples:
            - en
        flags:
          $ref: '#/components/schemas/Flags'
        certifications:
          items:
            $ref: '#/components/schemas/Certification'
          type: array
          title: Certifications
        interests:
          $ref: '#/components/schemas/Interests'
      type: object
      title: Person
    VerdictCore:
      properties:
        tier:
          anyOf:
            - type: string
            - type: 'null'
          title: Tier
          description: owner | executive | function_leader | manager | individual
          examples:
            - owner
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
        function:
          anyOf:
            - type: string
            - type: 'null'
          title: Function
          examples:
            - sales
        belongs:
          anyOf:
            - type: string
            - type: 'null'
          title: Belongs
          description: confirmed (employer id-matched) | likely (name-match only)
          examples:
            - confirmed
        why:
          anyOf:
            - type: string
            - type: 'null'
          title: Why
        hook:
          anyOf:
            - type: string
            - type: 'null'
          title: Hook
      type: object
      title: VerdictCore
    Contact:
      properties:
        email:
          anyOf:
            - $ref: '#/components/schemas/EmailInfo'
            - type: 'null'
        websites:
          items:
            type: string
          type: array
          title: Websites
        bio_links:
          items:
            $ref: '#/components/schemas/BioLink'
          type: array
          title: Bio Links
      type: object
      title: Contact
    ExperienceItem:
      properties:
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        company:
          anyOf:
            - type: string
            - type: 'null'
          title: Company
        company_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Company Id
        employment_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Employment Type
        workplace_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Workplace Type
        start:
          anyOf:
            - type: string
            - type: 'null'
          title: Start
        end:
          anyOf:
            - type: string
            - type: 'null'
          title: End
        duration:
          anyOf:
            - type: string
            - type: 'null'
          title: Duration
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
      type: object
      title: ExperienceItem
    EducationItem:
      properties:
        school:
          anyOf:
            - type: string
            - type: 'null'
          title: School
        degree:
          anyOf:
            - type: string
            - type: 'null'
          title: Degree
        field:
          anyOf:
            - type: string
            - type: 'null'
          title: Field
        start:
          anyOf:
            - type: string
            - type: 'null'
          title: Start
        end:
          anyOf:
            - type: string
            - type: 'null'
          title: End
      type: object
      title: EducationItem
    Signals:
      properties:
        recommendations_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Recommendations Count
        recommendations:
          items:
            $ref: '#/components/schemas/Recommendation'
          type: array
          title: Recommendations
        posts_about_own_company:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Posts About Own Company
        avg_engagement:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Engagement
        recent_posts:
          items:
            $ref: '#/components/schemas/RecentPost'
          type: array
          title: Recent Posts
        authored_articles:
          items:
            $ref: '#/components/schemas/Article'
          type: array
          title: Authored Articles
        last_active:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Active
          description: >-
            Date of their most recent post or reshare (ISO YYYY-MM-DD) — is the
            profile alive.
          examples:
            - '2026-06-20'
      type: object
      title: Signals
    Meta:
      properties:
        linkedin_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin Id
        profile_urn:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile Urn
        has_real_photo:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Real Photo
        photo_uploaded_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Photo Uploaded At
          description: When the owner last changed their photo.
        photo_expires_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Photo Expires At
          description: When the signed image URL expires (null = permanent).
      type: object
      title: Meta
    PersonLocation:
      properties:
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
          description: Display location line (LinkedIn's own text).
          examples:
            - Glendale, California, United States
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
          examples:
            - Glendale
        region:
          anyOf:
            - type: string
            - type: 'null'
          title: Region
          description: State / province / region.
          examples:
            - California
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
          description: Country name.
          examples:
            - United States
        country_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Country Code
          description: ISO 3166-1 alpha-2 country code.
          examples:
            - US
      type: object
      title: PersonLocation
      description: >-
        Where the person is — structured, not a flat string. `text` is the
        display line (always present);

        `city`/`region`/`country`/`country_code` come from the harvestapi
        geo-parse (null on sources that

        only give raw text, e.g. a BrightData-only profile). Mirrors
        CompanyLocation so both are queryable.
    Flags:
      properties:
        open_to_work:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Open To Work
        hiring:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Hiring
        premium:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Premium
        verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Verified
        influencer:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Influencer
        creator:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Creator
      type: object
      title: Flags
    Certification:
      properties:
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        issued_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Issued By
      type: object
      title: Certification
    Interests:
      properties:
        groups:
          items:
            $ref: '#/components/schemas/InterestGroup'
          type: array
          title: Groups
        newsletters:
          items:
            $ref: '#/components/schemas/InterestNewsletter'
          type: array
          title: Newsletters
      type: object
      title: Interests
      description: >-
        What the person follows on LinkedIn — a topical/qualification signal.
        Groups reveal a professional

        niche; newsletters reveal a current topical interest. Up to 3 of each.
    EmailInfo:
      properties:
        address:
          anyOf:
            - type: string
            - type: 'null'
          title: Address
          examples:
            - jane@acme.com
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
          description: valid | risky | invalid
          examples:
            - valid
        quality_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Quality Score
          examples:
            - 92
        catch_all_domain:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Catch All Domain
        valid_email_server:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Valid Email Server
        free:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Free
        source:
          anyOf:
            - type: string
            - type: 'null'
          title: Source
          description: verified (findEmail SMTP) | guessed (pattern on catch-all)
          examples:
            - verified
      type: object
      title: EmailInfo
    BioLink:
      properties:
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
      type: object
      title: BioLink
    Recommendation:
      properties:
        by:
          anyOf:
            - type: string
            - type: 'null'
          title: By
        by_headline:
          anyOf:
            - type: string
            - type: 'null'
          title: By Headline
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
      type: object
      title: Recommendation
    RecentPost:
      properties:
        content:
          anyOf:
            - type: string
            - type: 'null'
          title: Content
        posted_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Posted At
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
        is_repost:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Repost
        engagement:
          $ref: '#/components/schemas/Engagement'
      type: object
      title: RecentPost
    Article:
      properties:
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        link:
          anyOf:
            - type: string
            - type: 'null'
          title: Link
        published:
          anyOf:
            - type: string
            - type: 'null'
          title: Published
      type: object
      title: Article
    InterestGroup:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
          examples:
            - https://www.linkedin.com/groups/2124257
        members:
          anyOf:
            - type: integer
            - type: 'null'
          title: Members
          description: Group size (member count).
          examples:
            - 137932
      type: object
      title: InterestGroup
    InterestNewsletter:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        about:
          anyOf:
            - type: string
            - type: 'null'
          title: About
          description: Newsletter description.
        cadence:
          anyOf:
            - type: string
            - type: 'null'
          title: Cadence
          description: daily | weekly | biweekly | monthly
          examples:
            - monthly
      type: object
      title: InterestNewsletter
    Engagement:
      properties:
        likes:
          anyOf:
            - type: integer
            - type: 'null'
          title: Likes
        comments:
          anyOf:
            - type: integer
            - type: 'null'
          title: Comments
        shares:
          anyOf:
            - type: integer
            - type: 'null'
          title: Shares
      type: object
      title: Engagement

````