CB Insights Outlook API

openapi: 3.2.0
info:
  description: '# Introduction


    The CB Insights API offers market data and insights you won''t find anywhere else.'
  title: CB Insights Outlook API
  contact: {}
  version: '2.0'
  x-logo:
    altText: CB Insights logo
    backgroundColor: '#FFFFFF'
    href: https://api-docs.cbinsights.com/v2/
    url: https://api-docs.cbinsights.com/images/CBI_Logo_Color.svg
servers:
- url: https://api.cbinsights.com
tags:
- description: 'This dataset contains proprietary data science analysis including Mosaic Score, Commercial Maturity, and Exit Probability. Proven to predict winners better than top VCs.


    More about these proprietary datasets and methodology: https://support.cbinsights.com/hc/en-us/sections/360008544011-Proprietary-Datasets'
  name: Outlook
paths:
  /v2/organizations/{orgId}/commercialmaturityhistory:
    post:
      security:
      - BearerAuth: []
      description: Get commercial maturity history for the org with orgId
      tags:
      - Outlook
      summary: Retrieves historical commercial maturity scores
      parameters:
      - description: Authorization
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: CB Insights organization ID
        name: orgId
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2Outlook.CommercialMaturityHistoryResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v2Outlook.CommercialMaturityHistoryRequest'
        description: Request body
      operationId: postV2OrganizationsByOrgIdCommercialmaturityhistory
      x-operation-id-source: derived
  /v2/organizations/{orgId}/exitprobabilityhistory:
    post:
      security:
      - BearerAuth: []
      description: Get exit probability history for the org with orgId
      tags:
      - Outlook
      summary: Retrieves historical exit probability data
      parameters:
      - description: Authorization
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: CB Insights organization ID
        name: orgId
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2Outlook.ExitProbabilityHistoryResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v2Outlook.ExitProbabilityHistoryRequest'
        description: Request body
      operationId: postV2OrganizationsByOrgIdExitprobabilityhistory
      x-operation-id-source: derived
  /v2/organizations/{orgId}/fundingwindow:
    post:
      security:
      - BearerAuth: []
      description: Returns funding window for an organization.
      tags:
      - Outlook
      summary: List funding window data for a single organization
      parameters:
      - description: Authorization
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: CB Insights organization ID
        name: orgId
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2Outlook.FundingWindowResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: string
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '424':
          description: Failed Dependency
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
      operationId: postV2OrganizationsByOrgIdFundingwindow
      x-operation-id-source: derived
  /v2/organizations/{orgId}/mosaichistory:
    post:
      security:
      - BearerAuth: []
      description: Get mosaic history for the org with orgId
      tags:
      - Outlook
      summary: Retrieves historical mosaic scores
      parameters:
      - description: Authorization
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: CB Insights organization ID
        name: orgId
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2Outlook.MosaicHistoryResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v2Outlook.MosaicHistoryRequest'
        description: Request body
      operationId: postV2OrganizationsByOrgIdMosaichistory
      x-operation-id-source: derived
  /v2/organizations/{orgId}/outlook:
    post:
      security:
      - BearerAuth: []
      description: 'Returns values for the current commercial maturity, health, and exit probability scores. Proven to predict winners better than top VCs. More about proprietary datasets: https://support.cbinsights.com/hc/en-us/sections/360008544011-Proprietary-Datasets.'
      tags:
      - Outlook
      summary: Retrieve details about business outlook of an organization
      parameters:
      - description: Authorization
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: CB Insights organization ID
        name: orgId
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2Outlook.OutlookResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v2Outlook.OutlookRequest'
        description: Optional request parameters
      operationId: postV2OrganizationsByOrgIdOutlook
      x-operation-id-source: derived
  /v2/outlook:
    post:
      security:
      - BearerAuth: []
      description: Returns a list of outlook information for organizations based on the Org IDs provided.
      tags:
      - Outlook
      summary: List of outlook information for one or more organizations
      parameters:
      - description: Authorization
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2Outlook.OutlookListResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: string
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '424':
          description: Failed Dependency
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v2Outlook.OutlookListRequest'
        description: Search parameters to request outlook information.
        required: true
      operationId: postV2Outlook
      x-operation-id-source: derived
  /v2/outlook/fundingwindow:
    post:
      security:
      - BearerAuth: []
      description: Returns funding window for a list of organizations
      tags:
      - Outlook
      summary: List funding window data for a list of organizations
      parameters:
      - description: Authorization
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2Outlook.FundingWindowListResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: string
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '424':
          description: Failed Dependency
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.ErrorWithCode'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v2Outlook.FundingWindowListRequestBody'
        description: Search parameters
        required: true
      operationId: postV2OutlookFundingwindow
      x-operation-id-source: derived
components:
  schemas:
    v2Outlook.OrgOutlookResponse:
      type: object
      properties:
        commercialMaturity:
          description: 'CB Insights proprietary metric to measures a private company''s current ability to compete for customers or serve as a partner on a scale of 1-5.  This metric is available only for a subset of companies. More about this metric: https://support.cbinsights.com/hc/en-us/articles/25759259449485-About-Commercial-Maturity.'
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CommercialMaturity'
        exitProbability:
          description: 'CB Insights Exit Probability is a proprietary machine learning algorithm that measures a private company’s chance of an IPO or M&A exit within the next 2 years. More about this metric: https://support.cbinsights.com/hc/en-us/articles/29078253654413-About-Exit-Probability'
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CurrentExitProbability'
        mosaicScore:
          description: CB Insights’ proprietary algorithm to indicate the company’s potential for success. All scores based on a scale between 0-1000. For more on our methodology and forecasting success, https://support.cbinsights.com/hc/en-us/articles/360042055171-About-Mosaic-Health
          allOf:
          - $ref: '#/components/schemas/v2Outlook.MosaicScore'
        orgId:
          description: CB Insights organization ID.
          type: integer
          example: 129410
    v2Outlook.HistoricalExitProbabilityScore:
      type: object
      properties:
        asOfDate:
          description: The date at which the exit probability was calculated.
          type: string
          example: '2025-03-20'
        exitProbability:
          description: The exit probability of the company within 2 years from the date of calculation (asOfDate)
          type: number
          example: 22.43
        meanProbability:
          description: The mean exit probability of similar companies.
          type: number
          example: 21.33
        ratioToMean:
          description: The exit probability of the company as compared to similar companies.
          type: number
          example: 1.05
    v2Outlook.ExitProbabilityHistoryRequest:
      type: object
      properties:
        endDate:
          description: The end date of the exit probability history. If provided, it must be (a) a date equal to or later than '2025-02-25' and (b) at most 24 months later than StartDate. If not provided, defaults to today's date.
          type: string
          example: '2025-04-15'
        startDate:
          description: The start date of the exit probability history. If provided, it must be (a) a date equal to or later than '2025-02-25' and (b) at most 24 months ago from EndDate. If not provided, defaults to the later of '1 year ago from current date or '2025-02-25'.
          type: string
          example: '2025-03-01'
    v2Outlook.CommercialMaturitySignals:
      type: object
      properties:
        asOfDate:
          description: The date at which the commercial maturity signals were calculated.
          type: string
          example: '2025-02-21'
        signals:
          description: Signals that are affecting the commercial maturity of the company.
          type: array
          items:
            type: string
          example:
          - High IPO rate in sector
          - High latest funding
    v2Outlook.OutlookRequest:
      type: object
      properties:
        mosaicScoreVersion:
          description: Deprecated. Only Mosaic v2.1 is served.
          type: string
          example: v2.1
    v2Outlook.CohortLandscapes:
      type: object
      properties:
        businessModels:
          description: Cohort landscape business models.
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.BusinessModelLandscape'
        technologies:
          description: Cohort landscape technologies.
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.TechnologyLandscape'
    v2Outlook.TechnologyLandscape:
      type: object
      properties:
        technologyId:
          description: The CBI ID of the technology landscape; see https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/technologies
          type: integer
          example: 1
        technologyName:
          description: The name of the technology landscape.
          type: string
          example: Defense Tech
    v2Outlook.CurrentExitProbability:
      type: object
      properties:
        exitSignals:
          description: Signals that are affecting the exit probability of the company.
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.ExitSignal'
        ipo:
          description: The exit probability of the company within the next 2 years via an IPO.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.ExitProbabilityScore'
        mna:
          description: The exit probability of the company within the next 2 years via an M&A.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.ExitProbabilityScore'
    v2Outlook.FundingWindowResponse:
      type: object
      properties:
        cohortCriteria:
          description: Criteria used to define the cohort.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CohortCriteria'
        cohortNextRoundRate:
          description: The percentage of this cohort that historically raised another round, expressed as a decimal between 0 and 1.
          type: number
          example: 0.357353
        latestFunding:
          description: The latest equity backed funding.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.LatestFunding'
        windowEnd:
          description: The estimated funding window end date.
          type: string
          example: '2022-04-08'
        windowStart:
          description: The estimated funding window start date.
          type: string
          example: '2022-01-02'
    v2Outlook.CommercialMaturityHistoryResponse:
      type: object
      properties:
        commercialMaturityHistory:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.MaturityLevel'
    v2Outlook.HistoricalMosaicScore:
      type: object
      properties:
        asOfDate:
          description: Date at which the Mosaic Score was calculated.
          type: string
          example: '2025-02-15'
        scoreValue:
          description: Value of the Mosaic Score.
          type: number
          example: 237
    v2Outlook.OutlookListResponse:
      type: object
      properties:
        orgs:
          description: 'A list of organizations with their outlook information.

            If an Org ID has no data, it will be excluded from the response.'
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.OrgOutlookResponse'
    v2Outlook.MosaicHistoryRequest:
      type: object
      properties:
        mosaicScoreVersion:
          description: Deprecated. Only Mosaic v2.1 is served.
          type: string
          example: v2.1
        startDate:
          description: The start date of the mosaic history data. If provided, it must be (a) a date equal to or later than '2024-01-01' and (b) at most 24 months ago from current date. If not provided, defaults to the later of '1 year ago or 2024-01-01'.
          type: string
          example: '2025-02-15'
    v2Outlook.ScoreInsights:
      type: object
      properties:
        negativeTags:
          type: array
          items:
            type: string
        percentile:
          type: number
        pointChange:
          $ref: '#/components/schemas/v2Outlook.PointChange'
        positiveTags:
          type: array
          items:
            type: string
    v2Outlook.CurrentMosaicScore:
      type: object
      properties:
        asOfDate:
          description: Date at which the Mosaic Score was calculated.
          type: string
          example: '2025-02-15'
        scoreInsights:
          description: Insight into the Mosaic Score.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.ScoreInsights'
        scoreValue:
          description: Value of the Mosaic Score.
          type: number
          example: 237
    v2Outlook.LatestFunding:
      type: object
      properties:
        date:
          description: The date when the funding took place, in the format YYYY-MM-DD.
          type: string
          example: '2025-02-15'
        dealId:
          description: The latest funding deal ID.
          type: integer
          example: 7153
    v2Outlook.ExitSignal:
      type: object
      properties:
        direction:
          description: The direction in which the signal is trending for the company (positive, negative, or unspecified).
          type: string
          example: positive
        signal:
          description: A Signal that affects the exit probability of the company.
          type: string
          example: High employee headcount
    v2Outlook.ExitProbabilityHistoryResponse:
      type: object
      properties:
        ipo:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.HistoricalExitProbabilityScore'
        mna:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.HistoricalExitProbabilityScore'
    v2Outlook.OutlookResponse:
      type: object
      properties:
        commercialMaturity:
          description: 'CB Insights proprietary metric to measures a private company''s current ability to compete for customers or serve as a partner on a scale of 1-5.  This metric is available only for a subset of companies. More about this metric: https://support.cbinsights.com/hc/en-us/articles/25759259449485-About-Commercial-Maturity.'
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CommercialMaturity'
        exitProbability:
          description: 'CB Insights Exit Probability is a proprietary machine learning algorithm that measures a private company’s chance of an IPO or M&A exit within the next 2 years. More about this metric: https://support.cbinsights.com/hc/en-us/articles/29078253654413-About-Exit-Probability'
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CurrentExitProbability'
        mosaicScore:
          description: CB Insights’ proprietary algorithm to indicate the company’s potential for success. All scores based on a scale between 0-1000. For more on our methodology and forecasting success, https://support.cbinsights.com/hc/en-us/articles/360042055171-About-Mosaic-Health
          allOf:
          - $ref: '#/components/schemas/v2Outlook.MosaicScore'
    v2Outlook.FundingWindowListRequestBody:
      type: object
      properties:
        orgIds:
          description: List of Org IDs to look up, the request must contain 1 - 100 Org IDs.
          type: array
          items:
            type: integer
          example:
          - 129410
          - 1034157
    v2Outlook.BusinessModelLandscape:
      type: object
      properties:
        businessModel:
          description: The name of the business model landscape.
          type: string
          example: SaaS
        businessModelId:
          description: The CBI ID of the business model landscape; see https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/business-models
          type: integer
          example: 7
    v2Outlook.FundingWindowOrg:
      type: object
      properties:
        cohortCriteria:
          description: Criteria used to define the cohort.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CohortCriteria'
        cohortNextRoundRate:
          description: The percentage of this cohort that historically raised another round, expressed as a decimal between 0 and 1.
          type: number
          example: 0.357353
        latestFunding:
          description: The latest equity backed funding.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.LatestFunding'
        orgId:
          description: CB Insights Organization ID.
          type: integer
          example: 7
        windowEnd:
          description: The estimated funding window end date.
          type: string
          example: '2022-04-08'
        windowStart:
          description: The estimated funding window start date.
          type: string
          example: '2022-01-02'
    v2Outlook.PointChange:
      type: object
      properties:
        baseDateForPointChange:
          type: string
        pointChange:
          type: number
    v2Outlook.CommercialMaturityHistoryRequest:
      type: object
      properties:
        endDate:
          description: The end date of the commercial maturity score history. If provided, it must be (a) a date equal to or later than '2024-07-25' and (b) at most 24 months later than StartDate. If not provided, defaults to today's date.
          type: string
          example: '2025-04-15'
        startDate:
          description: The start date of the commercial maturity score history. If provided, it must be (a) a date equal to or later than '2024-07-25' and (b) at most 24 months ago from EndDate. If not provided, defaults to the later of '1 year ago from current date or '2024-07-25'.
          type: string
          example: '2025-01-01'
    common.ErrorWithCode:
      type: object
      properties:
        error:
          type: string
    v2Outlook.CommercialMaturity:
      type: object
      properties:
        commercialMaturitySignals:
          description: Signals that are affecting the commercial maturity of the company.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CommercialMaturitySignals'
        maturityLevel:
          description: The maturity level of the company.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.MaturityLevel'
    v2Outlook.OutlookListRequest:
      type: object
      properties:
        mosaicScoreVersion:
          description: Deprecated. Only Mosaic v2.1 is served.
          type: string
          example: v2.1
        orgIds:
          description: List of Org IDs to look up, the request must contain 1 - 100 Org IDs.
          type: array
          items:
            type: integer
          example:
          - 129410
          - 129411
    v2Outlook.ExitProbabilityScore:
      type: object
      properties:
        asOfDate:
          description: Date at which the exit probability was calculated.
          type: string
          example: '2025-03-20'
        exitProbability:
          description: The exit probability of the company within the next 2 years.
          type: number
          example: 22.43
        meanProbability:
          description: The mean exit probability of similar companies.
          type: number
          example: 21.33
        ratioToMean:
          description: The exit probability of the company as compared to similar companies.
          type: number
          example: 1.05
    v2Outlook.MaturityLevel:
      type: object
      properties:
        asOfDate:
          description: The date at which the maturity level was calculated.
          type: string
          example: 02/21/2025
        level:
          description: The maturity level of the company.
          type: integer
          example: 5
        stage:
          description: The stage of the company.
          type: string
          example: Established
        stageDescription:
          description: Description of the stage of the company.
          type: string
          example: Major market presence
    v2Outlook.MosaicScore:
      type: object
      properties:
        management:
          description: A Mosaic sub-score that measures the pedigree, education, and work experience of the leaders of the company.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CurrentMosaicScore'
        market:
          description: A Mosaic sub-score that measures the health of the industry in which the company is categorized.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CurrentMosaicScore'
        momentum:
          description: A Mosaic sub-score that measures the financial health of the company.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CurrentMosaicScore'
        money:
          description: A Mosaic sub-score that measures the traction of the company based on the company’s business signals, such as vendors, partners, social media, and news sentiment.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CurrentMosaicScore'
        overall:
          description: Overall Mosaic Score of the company. This is a composite score that measures the overall health of the company based on the company’s business signals, such as vendors, partners, social media, and news sentiment.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CurrentMosaicScore'
    v2Outlook.CohortCriteria:
      type: object
      properties:
        cohortGeo:
          description: The cohort Geography.
          type: string
          example: North America
        cohortLandscapes:
          description: The cohort landscapes.
          allOf:
          - $ref: '#/components/schemas/v2Outlook.CohortLandscapes'
        cohortRoundCategory:
          description: The cohort funding round category.
          type: string
          example: Series B
    v2Outlook.FundingWindowListResponse:
      type: object
      properties:
        orgs:
          description: List of funding window data for the requested Org IDs. If an Org ID has no data, it will be excluded from the response.
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.FundingWindowOrg'
    v2Outlook.MosaicHistoryResponse:
      type: object
      properties:
        management:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.HistoricalMosaicScore'
        market:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.HistoricalMosaicScore'
        momentum:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.HistoricalMosaicScore'
        money:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.HistoricalMosaicScore'
        overall:
          type: array
          items:
            $ref: '#/components/schemas/v2Outlook.HistoricalMosaicScore'
  securitySchemes:
    BearerAuth:
      description: Type "Bearer" followed by a space and JWT token.
      type: apiKey
      name: Authorization
      in: header
externalDocs:
  description: CBI API v1 reference
  url: https://api-docs.cbinsights.com/