Skip to main content

Fill Rate

Data completness for selected fields:
FieldTotalUS
company_info.name100%100%
company_info.websites15%75%
company_info.locations18%100%
company_info.industry15%80%
company_info.linkedin_slugs22%99%

JSON Schema

Below is the complete JSON Schema for the data model returned by the Fetch Company endpoint. This schema provides a detailed blueprint of the JSON response, including its structure and data types, ensuring clarity and precision for the company model.
{
  "Company": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid"
      },
      "company_info": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "crunchbase_id": {
            "type": "string"
          },
          "crunchbase_slug": {
            "type": "string"
          },
          "stock_ticker": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "alternative_names": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "description": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "contact_info": {
            "type": "string"
          },
          "canonical_name": {
            "type": "string"
          },
          "founded": {
            "type": "string",
            "format": "date-time"
          },
          "industry": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "size": {
            "type": "object",
            "properties": {
              "class": {
                "type": "string"
              }
            }
          },
          "workforce": {
            "type": "object",
            "properties": {
              "headcount": {
                "type": "integer"
              },
              "historical_headcount": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "timestamp": {
                      "type": "integer"
                    },
                    "count": {
                      "type": "integer"
                    }
                  }
                }
              },
              "size_class": {
                "type": "string"
              }
            }
          }
        },
        "tech_stack": {
          "type": "object",
          "properties": {
            "products": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "business_data": {
          "type": "object",
          "properties": {
            "identifiers": {
              "type": "object",
              "properties": {
                "stock_ticker": {
                  "type": "string"
                },
                "duns_code": {
                  "type": "string"
                },
                "cage_code": {
                  "type": "string"
                },
                "naics_code": {
                  "type": "string"
                }
              }
            },
            "customer_types": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "stock_exchange": {
              "type": "string"
            },
            "is_acquired": {
              "type": "boolean"
            },
            "is_exited": {
              "type": "boolean"
            },
            "is_government": {
              "type": "boolean"
            },
            "is_non_profit": {
              "type": "boolean"
            },
            "is_shut_down": {
              "type": "boolean"
            },
            "is_startup": {
              "type": "boolean"
            },
            "is_stealth": {
              "type": "boolean"
            },
            "ownership_status": {
              "type": "string"
            },
            "ownership_status_detailed": {
              "type": "string"
            },
            "patent_count": {
              "type": "integer"
            },
            "financing_profile": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string"
                },
                "ipo_date": {
                  "type": "string",
                  "format": "date-time"
                },
                "outstanding_shares": {
                  "type": "number"
                },
                "market_cap": {
                  "type": "number"
                }
              }
            }
          }
        },
        "social_media": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "network": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "slug": {
                "type": "string"
              }
            }
          }
        },
        "linkedin_slugs": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "locations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "is_primary": {
                "type": "boolean"
              }
            }
          }
        },
        "logo_url": {
          "type": "string"
        },
        "type": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "specialities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "investments": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "geography_focus": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "funding": {
          "type": "object",
          "properties": {
            "last_round": {
              "type": "object",
              "properties": {
                "last_round_type": {
                  "type": "string"
                },
                "last_round_amount_usd": {
                  "type": "integer"
                },
                "last_round_date": {
                  "type": "string",
                  "format": "date-time"
                },
                "last_round_investors": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "kind": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "crunchbase_id": {
                        "type": "string"
                      },
                      "crunchbase_slug": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            },
            "rounds": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "amount_usd": {
                    "type": "integer"
                  },
                  "date": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "investors": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "kind": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "crunchbase_id": {
                          "type": "string"
                        },
                        "crunchbase_slug": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            },
            "total_funding_amount_usd": {
              "type": "integer"
            }
          }
        },
        "updated_at": {
          "type": "string",
          "format": "date-time"
        },
        "created_at": {
          "type": "string",
          "format": "date-time"
        },
        "data_updated_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    }
  }
}
}

Company Example

An example of the company record returned by the Company Fetch endpoint is given below.
{
  "results": [
    {
      "id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
      "company_info": {
        "id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
        "crunchbase_id": "b7cf00de-232c-4bbd-b6ce-8d2fa806e90d",
        "crunchbase_slug": "the-swarm-e90d",
        "stock_ticker": "SWRM",
        "name": "The Swarm",
        "canonical_name": "wearetheswarm",
        "alternative_names": [
          "The Swarm",
          "The Network Relationship Management (NRM) Platform"
        ],
        "description": "The Swarm equips you with high-fidelity people data and industry-leading business relationship insights.",
        "summary": "Your Go-To-Network Platform.",
        "contact_info": "www.theswarm.com/company/contact",
        "founded": "2021-01-01T00:00:00Z",
        "industry": "Business Development",
        "website": "theswarm.com",
        "size": {
          "class": "11-50"
        },
        "workforce": {
          "headcount": 19,
          "historical_headcount": [
            {
              "timestamp": 1627776000000,
              "count": 1
            },
            {
              "timestamp": 1643554476000,
              "count": 3
            },
            {
              "timestamp": 1646184222000,
              "count": 7
            }
          ],
          "size_class": "11-50"
        },
        "tech_stack": {
          "products": [
            "mongodb",
            "mysql",
            "nosql",
            "userzoom",
            "ios"
          ]
        },
        "business_data": {
          "identifiers": {
            "stock_ticker": "SWRM",
            "duns_code": "884745530",
            "cage_code": "1A2B3",
            "naics_code": "884745530"
          },
          "customer_types": [
            "B2G",
            "B2C"
          ],
          "stock_exchange": "NASDAQ",
          "is_acquired": false,
          "is_exited": false,
          "is_government": false,
          "is_non_profit": false,
          "is_shut_down": false,
          "is_startup": true,
          "is_stealth": false,
          "ownership_status": "active",
          "ownership_status_detailed": "Privately Held (backing)",
          "patent_count": 4,
          "financing_profile": {
            "status": "Venture Capital-Backed",
            "ipo_date": "2017-05-15T13:30:00Z",
            "outstanding_shares": 2200000000,
            "market_cap": 1984507936768
          }
        },
        "social_media": [
          {
            "network": "crunchbase",
            "slug": "the-swarm-e90d",
            "url": "crunchbase.com/organization/the-swarm-e90d"
          },
          {
            "network": "dealroom",
            "url": "app.dealroom.co/companies/the_swarm_1"
          },
          {
            "network": "facebook",
            "url": "www.facebook.com/wearetheswarm"
          },
          {
            "network": "linkedin",
            "slug": "wearetheswarm",
            "url": "linkedin.com/company/wearetheswarm"
          },
          {
            "id": "496661-59",
            "network": "pitchbook",
            "url": "pitchbook.com/profiles/company/496661-59"
          },
          {
            "network": "twitter",
            "url": "twitter.com/wearetheswarm"
          }
        ],
        "linkedin_slugs": [
          "wearetheswarm"
        ],
        "locations": [
          {
            "name": "San Francisco, California, United States",
            "country": "United States",
            "is_primary": true
          },
          {
            "name": "Kraków",
            "country": "Poland",
            "is_primary": false
          }
        ],
        "logo_url": "https://cdn.theswarm.com/companies/logos/09d/9c5/09d9c510-c9f6-4c6e-9e62-fe5fedbeda87/300x300/c246b0439337c792a9651899b27570bc.jpeg",
        "type": [
          "fund of funds",
          "venture fund"
        ],
        "specialities": [
          "network",
          "network management",
          "sales",
          "go-to-network"
        ],
        "investments": [
          "pre-seed",
          "seed"
        ],
        "geography_focus": [
          "united states"
        ],
        "funding": {
          "last_round": {
            "last_round_type": "seed",
            "last_round_amount_usd": 1000000,
            "last_round_date": "2023-12-01T00:00:00Z",
            "last_round_investors": [
              {
                "id": "aa17de4b-bff3-470e-b2e2-69e3d048b50b",
                "kind": "Company",
                "name": "Microsoft",
                "crunchbase_id": "fd80725f-53fc-7009-9878-aeecf1e9ffbb",
                "crunchbase_slug": "microsoft"
              }
            ]
          },
          "rounds": [
            {
              "type": "seed",
              "amount_usd": 1000000,
              "date": "2023-12-01T00:00:00Z",
              "investors": [
                {
                  "id": "aa17de4b-bff3-470e-b2e2-69e3d048b50b",
                  "kind": "Company",
                  "name": "Microsoft",
                  "crunchbase_id": "fd80725f-53fc-7009-9878-aeecf1e9ffbb",
                  "crunchbase_slug": "microsoft"
                }
              ]
            }
          ],
          "total_funding_amount_usd": 1000000
        },
        "updated_at": "2025-06-27T11:26:19.545665638Z",
        "created_at": "2023-07-25T16:58:09.358089Z",
        "data_updated_at": "2025-06-27T11:26:19.545665638Z"
      }
    }
  ]
}

I