Look up growth predictions

Before you begin

Your API key must include the fields and collections requested below. Check your API package if an endpoint or field is unavailable. Complete your first API request to set CRUNCHBASE_API_KEY in bash or zsh. Commands below include response headers; look for HTTP 200, then read the JSON body.

Primary APIs: Growth Prediction Search and Growth Prediction Lookup

Before interpreting the results, review prediction scores and timing.

1. Find growth predictions

Endpoint

POST https://api.crunchbase.com/v4/data/searches/growth_predictions

Query

Search for Writer’s growth prediction records using its organization UUID, a3674669-6d9e-4f70-895f-3c8c99bcb7ad, then identify the latest record as described below.

Scroll to view all columns →

Run this query to retrieve Writer’s available growth prediction records:

curl --include --request POST \
  --url 'https://api.crunchbase.com/v4/data/searches/growth_predictions' \
  --header "X-cb-user-key: $CRUNCHBASE_API_KEY" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "field_ids": [
    "organization",
    "generated_on"
  ],
  "query": [
    {
      "field_id": "organization",
      "operator_id": "includes",
      "type": "predicate",
      "values": [
        "a3674669-6d9e-4f70-895f-3c8c99bcb7ad"
      ]
    }
  ],
  "limit": 3
}'

Read generated_on to identify the latest prediction. This request does not specify a sort order. Paginate through all matching records, preserve the organization filter, and select the record with the greatest generated_on value. Use that record’s UUID in Step 2; do not assume the first returned record is the latest.

Example response

The historical example below shows one of 10 matching growth prediction records, including its date and UUID. count is the total matches; entities contains the returned page. The sample is shortened, so other fields and records may be omitted. Counts and values can change.

{
  "count": 10,
  "entities": [
    {
      "uuid": "030b0f7c-8dc3-4b25-9ce2-baed5d8f1ee6",
      "properties": {
        "identifier": {
          "image_id": "0566443d3dbe4075aa9dad798801e206",
          "uuid": "030b0f7c-8dc3-4b25-9ce2-baed5d8f1ee6",
          "entity_def_id": "growth_prediction",
          "value": "Growth Prediction 2026-03-28"
        },
        "organization": {
          "permalink": "writer",
          "image_id": "jqgtyt2qclr1ikl5mpjv",
          "uuid": "a3674669-6d9e-4f70-895f-3c8c99bcb7ad",
          "entity_def_id": "organization",
          "value": "Writer"
        },
        "generated_on": "2026-03-28"
      }
    }
  ]
}

Interpret the response

Each returned entity identifies a growth prediction for the selected organization. Compare properties.generated_on across all matching pages and use the UUID of the latest record in Step 2.

2. Retrieve the latest growth prediction

Retrieve the selected growth prediction’s probability score, probability tier, and context fields using its UUID.

Endpoint

GET https://api.crunchbase.com/v4/data/entities/growth_predictions/{entity_id}

Query

Replace {prediction_uuid} with the UUID of the latest growth prediction selected in Step 1:

Fields used in this query

Scroll to view all columns →

curl --include --request GET \
  --url 'https://api.crunchbase.com/v4/data/entities/growth_predictions/{prediction_uuid}?field_ids=created_at,probability_score,probability_tier,runway_speculation,key_employee_changes,unicorn_status&card_ids=fields' \
  --header "X-cb-user-key: $CRUNCHBASE_API_KEY" \
  --header 'Accept: application/json'

Example response

The following illustrative response shows a growth prediction lookup. Your response depends on the prediction UUID selected in Step 1. The shortened example shows selected top-level properties; the request explicitly selects the context fields shown below. card_ids=fields also returns a separate cards.fields object, which is omitted from this example. Fields may be absent when no value is available.

{
  "properties": {
    "identifier": {
      "uuid": "030b0f7c-8dc3-4b25-9ce2-baed5d8f1ee6",
      "value": "Growth Prediction 2026-01-24",
      "image_id": "7299fb1a70b6414b8adb52b6d56d486b",
      "entity_def_id": "growth_prediction"
    },
    "probability_score": 0.9529,
    "runway_speculation": {
      "uuid": "5d591058-76cc-4fa6-8ad1-be4d0186b70d",
      "value": "Series C - Writer",
      "image_id": "jqgtyt2qclr1ikl5mpjv",
      "permalink": "writer-series-c--5d591058",
      "entity_def_id": "funding_round"
    },
    "unicorn_status": "c200_evidence_present",
    "created_at": "2026-01-15T09:59:33Z",
    "key_employee_changes": [
      {
        "uuid": "d3be8cd0-ad46-4507-9c59-a0d44b234311",
        "image_id": "7299fb1a70b6414b8adb52b6d56d486b",
        "entity_def_id": "key_employee_change"
      },
      {
        "uuid": "356d3002-3eb9-43c1-b4f8-3c620bdc0f0c",
        "image_id": "7299fb1a70b6414b8adb52b6d56d486b",
        "entity_def_id": "key_employee_change"
      }
    ],
    "probability_tier": "p100_positive_high"
  }
}

Interpret the response

Inspect the prediction score and returned context:

Check your result

Check the organization UUID and prediction generation date before using a score. An empty result is not a zero probability. Interpret scores and timing using the prediction definitions.

Search requests here use limit: 3 for a small first page. Follow the pagination guidance above for a complete result set, preserving the filters and ordering. For request failures, use the shared request and retry guidance.