Entity lookup examples

Below are a few common examples to help you request data fields or relationships for a specific entity.

📘

Entity lookup requirements

Supply an entity_id using the entity’s UUID or permalink. Authenticate with your API key in the X-cb-user-key header.

Replace YOUR_API_KEY with your provisioned key. See Make your first API request for key setup.

Example 1: retrieve information for Tesla Motors

Information to retrieve for Tesla Motors:

• company firmographic - categories, short description, website and facebook URLs (field_ids = website,facebook,categories,short_description)
• who are their founder(s)? (card_ids=founders)
• when was the company founded? (field_ids=founded_on)
• which funding rounds did Tesla Motors raise? (card_ids=raised_funding_rounds)
• what's Tesla's Crunchbase Rank among companies across Crunchbase Graph? (field_ids=rank_org_company)

GET /v4/data/entities/organizations/tesla-motors?card_ids=founders,raised_funding_rounds&field_ids=categories,short_description,rank_org_company,founded_on,website,facebook,created_at HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json

Example 2: paginate results for Sequoia Capital's investments

Since Sequoia Capital (permalink = sequoia-capital) has more than 1,000 investments, we need to paginate to get more results from the participated_investments card because it only shows a max of 100 results.

Additionally, retrieve only the below information about Sequoia's investments and sort the results by highest funding raised:

• when was the announced date? (field_ids=announced_on)
• how much money did the funding round raise? (field_ids=funding_round_money_raised)
• which company raised the funding round? (field_ids=organization_identifier)
• which partner from Sequoia Capital is associated with the funding round? (field_ids=partner_identifiers)

In the example below, we are looking for the 2nd page of the results by using the after_id parameter (after_id = cc1e69b5-052d-577d-9c03-85097da862ed).

GET /v4/data/entities/organizations/sequoia-capital/cards/participated_investments?card_field_ids=announced_on%2Cfunding_round_money_raised%2Corganization_identifier%2Cpartner_identifiers&after_id=cc1e69b5-052d-577d-9c03-85097da862ed&order=funding_round_money_raised%20desc HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json