PublicPrivateCompanyOverviewResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bigdata/json-schema/bigdata-public-private-company-overview-response-schema.json",
  "title": "PublicPrivateCompanyOverviewResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bigdata-private-markets-api-openapi.yml#/components/schemas/PublicPrivateCompanyOverviewResponse",
  "properties": {
    "results": {
      "items": {
        "$ref": "#/$defs/PublicPrivateCompanyOverview"
      },
      "type": "array",
      "title": "Results",
      "description": "One overview per requested ID, in request order. A company with no overview to serve carries only its rp_entity_id, which covers a company we cannot map, a mapped company with no record, and a lookup that failed."
    },
    "errors": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/ErrorDetail"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Errors"
    },
    "metadata": {
      "$ref": "#/$defs/Metadata"
    },
    "sources": {
      "items": {
        "$ref": "#/$defs/Source"
      },
      "type": "array",
      "title": "Sources",
      "description": "The content catalog sources the response was built from, one entry per source. Empty when no catalog source contributed."
    },
    "usage": {
      "anyOf": [
        {
          "$ref": "#/$defs/Usage"
        },
        {
          "type": "null"
        }
      ],
      "description": "Tokens the request consumed, per content tier. Present only for API keys billed in tokens."
    }
  },
  "type": "object",
  "required": [
    "results",
    "metadata"
  ],
  "$defs": {
    "ActivityRank": {
      "properties": {
        "overall_rank": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Overall Rank",
          "description": "Where the company stands against all other companies, with 1 as the top. Calculated by the data provider from signals such as total funding, relationships with other organizations, and recent attention, so it moves as the company's activity changes."
        },
        "change_7d": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Change 7D",
          "description": "Movement in the rank over the last 7 days, a score from -10 to 10."
        },
        "change_30d": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Change 30D",
          "description": "Movement in the rank over the last 30 days, a score from -10 to 10."
        },
        "change_90d": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Change 90D",
          "description": "Movement in the rank over the last 90 days, a score from -10 to 10."
        }
      },
      "type": "object",
      "title": "ActivityRank",
      "description": "A company's position in the data provider's ranking, and how it has moved."
    },
    "Address": {
      "properties": {
        "street_1": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Street 1",
          "description": "First line of the street address."
        },
        "street_2": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Street 2",
          "description": "Second line of the street address."
        },
        "postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Postal Code",
          "description": "Postal code."
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "City",
          "description": "City name."
        },
        "region": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Region",
          "description": "State, province or region name."
        },
        "region_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Region Code",
          "description": "Code of the state, province or region."
        },
        "country": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Country",
          "description": "Country name."
        },
        "country_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Country Code",
          "description": "Two-letter country code."
        }
      },
      "type": "object",
      "title": "Address",
      "description": "A postal address."
    },
    "DatePrecision": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "day",
            "month",
            "year"
          ],
          "title": "DatePrecision",
          "description": "How much of a date is known. Parts of the date beyond it carry no meaning."
        },
        {
          "type": "string"
        }
      ]
    },
    "DateWithPrecision": {
      "properties": {
        "value": {
          "type": "string",
          "format": "date",
          "title": "Value",
          "description": "The date."
        },
        "precision": {
          "anyOf": [
            {
              "$ref": "#/$defs/DatePrecision"
            },
            {
              "type": "null"
            }
          ],
          "description": "How much of the date is known. Parts of the date beyond it carry no meaning."
        }
      },
      "type": "object",
      "required": [
        "value"
      ],
      "title": "DateWithPrecision",
      "description": "A date that may be known only to the month or the year."
    },
    "ErrorDetail": {
      "properties": {
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Message"
        }
      },
      "type": "object",
      "title": "ErrorDetail"
    },
    "FundingType": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "angel",
            "convertible_note",
            "corporate_round",
            "debt_financing",
            "equity_crowdfunding",
            "grant",
            "initial_coin_offering",
            "non_equity_assistance",
            "post_ipo_debt",
            "post_ipo_equity",
            "post_ipo_secondary",
            "pre_seed",
            "private_equity",
            "product_crowdfunding",
            "secondary_market",
            "seed",
            "series_a",
            "series_b",
            "series_c",
            "series_d",
            "series_e",
            "series_f",
            "series_g",
            "series_h",
            "series_i",
            "series_j",
            "series_unknown",
            "undisclosed"
          ],
          "title": "FundingType",
          "description": "The kind of a funding round."
        },
        {
          "type": "string"
        }
      ]
    },
    "IpoStatus": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "delisted",
            "private",
            "public"
          ],
          "title": "IpoStatus",
          "description": "Whether the company is listed."
        },
        {
          "type": "string"
        }
      ]
    },
    "Metadata": {
      "properties": {
        "request_id": {
          "type": "string",
          "title": "Request Id"
        },
        "timestamp": {
          "type": "string",
          "title": "Timestamp"
        }
      },
      "type": "object",
      "required": [
        "request_id"
      ],
      "title": "Metadata"
    },
    "MoneyAmount": {
      "properties": {
        "value": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Value",
          "description": "The amount, in the currency it was reported in."
        },
        "currency": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Currency",
          "description": "Code of the reported currency."
        },
        "value_usd": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Value Usd",
          "description": "The amount converted to US dollars."
        }
      },
      "type": "object",
      "title": "MoneyAmount",
      "description": "An amount of money, as reported and converted to US dollars."
    },
    "OperatingStatus": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "active",
            "closed"
          ],
          "title": "OperatingStatus",
          "description": "Whether the company still operates."
        },
        {
          "type": "string"
        }
      ]
    },
    "PrivateCompanyType": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "for_profit",
            "non_profit"
          ],
          "title": "PrivateCompanyType",
          "description": "Whether the company is run for profit."
        },
        {
          "type": "string"
        }
      ]
    },
    "PublicPrivateCompanyOverview": {
      "properties": {
        "rp_entity_id": {
          "type": "string",
          "maxLength": 6,
          "minLength": 6,
          "title": "Rp Entity Id",
          "description": "The RavenPack entity ID this overview is for."
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Name",
          "description": "Company name."
        },
        "legal_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Legal Name",
          "description": "Registered legal name."
        },
        "short_description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Short Description",
          "description": "One-sentence description of the company."
        },
        "website": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Website",
          "description": "Company website."
        },
        "operating_status": {
          "anyOf": [
            {
              "$ref": "#/$defs/OperatingStatus"
            },
            {
              "type": "null"
            }
          ],
          "description": "Whether the company still operates."
        },
        "company_type": {
          "anyOf": [
            {
              "$ref": "#/$defs/PrivateCompanyType"
            },
            {
              "type": "null"
            }
          ],
          "description": "Whether the company is run for profit."
        },
        "ipo_status": {
          "anyOf": [
            {
              "$ref": "#/$defs/IpoStatus"
            },
            {
              "type": "null"
            }
          ],
          "description": "Whether the company is listed. A listed company still gets an overview."
        },
        "founded_on": {
          "anyOf": [
            {
              "$ref": "#/$defs/DateWithPrecision"
            },
            {
              "type": "null"
            }
          ],
          "description": "Date the company was founded."
        },
        "employee_range": {
          "anyOf": [
            {
              "prefixItems": [
                {
                  "type": "integer"
                },
                {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              ],
              "type": "array",
              "maxItems": 2,
              "minItems": 2
            },
            {
              "type": "null"
            }
          ],
          "title": "Employee Range",
          "description": "Headcount band as [min, max] employees, both inclusive. max is null for the open top band, [10001, null]."
        },
        "categories": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Categories",
          "description": "Industries the company works in."
        },
        "headquarters": {
          "anyOf": [
            {
              "$ref": "#/$defs/Address"
            },
            {
              "type": "null"
            }
          ],
          "description": "Address of the company's headquarters."
        },
        "funding_total": {
          "anyOf": [
            {
              "$ref": "#/$defs/MoneyAmount"
            },
            {
              "type": "null"
            }
          ],
          "description": "Total raised across every funding round."
        },
        "num_funding_rounds": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Num Funding Rounds",
          "description": "Number of funding rounds."
        },
        "last_funding_total": {
          "anyOf": [
            {
              "$ref": "#/$defs/MoneyAmount"
            },
            {
              "type": "null"
            }
          ],
          "description": "Amount raised in the most recent round."
        },
        "last_funding_type": {
          "anyOf": [
            {
              "$ref": "#/$defs/FundingType"
            },
            {
              "type": "null"
            }
          ],
          "description": "Type of the most recent round."
        },
        "last_funding_date": {
          "anyOf": [
            {
              "$ref": "#/$defs/DateWithPrecision"
            },
            {
              "type": "null"
            }
          ],
          "description": "Date of the most recent round."
        },
        "valuation": {
          "anyOf": [
            {
              "$ref": "#/$defs/MoneyAmount"
            },
            {
              "type": "null"
            }
          ],
          "description": "Most recent reported valuation. For a listed company it can be years old and is not a market capitalisation."
        },
        "valuation_date": {
          "anyOf": [
            {
              "$ref": "#/$defs/DateWithPrecision"
            },
            {
              "type": "null"
            }
          ],
          "description": "Date of the most recent valuation."
        },
        "activity_rank": {
          "anyOf": [
            {
              "$ref": "#/$defs/ActivityRank"
            },
            {
              "type": "null"
            }
          ],
          "description": "The data provider's ranking of the company, with its current position and recent movement. Null when the data provider sends none of the rank fields."
        }
      },
      "type": "object",
      "required": [
        "rp_entity_id"
      ],
      "title": "PublicPrivateCompanyOverview"
    },
    "Source": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id",
          "description": "Content catalog identifier of the source."
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "Catalog name of the dataset the data came from."
        }
      },
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "title": "Source",
      "description": "A content catalog source that contributed data to a structured-data response."
    },
    "Usage": {
      "additionalProperties": {
        "type": "integer"
      },
      "type": "object",
      "title": "Usage",
      "description": "Public structured-data usage for a request, aggregated per content tier.\n\nA flat object keyed per content tier, where each key is derived from the\ncontent tier identifier by dropping the ``content-`` prefix and appending\n``_tokens`` (e.g. ``corporate-fundamentals`` ->\n``corporate_fundamentals_tokens``). It is sparse: only tiers with non-zero\ntokens appear, and an absent key means zero tokens for that tier."
    }
  }
}