Skip to main content

Prerequisites

Before you begin, make sure you have:
  • A Happenstance account
  • API Credits (checkout via Settings)
  • Your API key (generated from Settings)

Make Your First Request

1. Research a Person

Generate a detailed profile:
curl -X POST https://api.happenstance.ai/v1/research \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Garry Tan Y Combinator"
  }'
Response:
{
  "id": "547e404b-0129-4400-b42d-038cca184414"
}
View the research profile at: https://happenstance.ai/research/{id}Research generation takes 1-3 minutes. The page will update automatically when complete.

2. Poll for Completion

Research runs asynchronously. Poll the GET endpoint until the status is COMPLETED:
curl -X GET https://api.happenstance.ai/v1/research/ \
  -H "Authorization: Bearer YOUR_API_KEY"
Response (in progress):
{
  "id": "547e404b-0129-4400-b42d-038cca184414",
  "status": "RUNNING",
  "query": "Garry Tan Y Combinator",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:05Z",
  "profile": null
}
Response (completed):
{
  "id": "547e404b-0129-4400-b42d-038cca184414",
  "status": "COMPLETED",
  "query": "Garry Tan Y Combinator",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:32:15Z",
  "profile": {
    "person_metadata": {
      "full_name": "Garry Tan",
      "alternate_names": [],
      "profile_urls": [
        "https://www.ycombinator.com/people/garry-tan",
        "https://x.com/garrytan",
        "https://www.linkedin.com/in/garrytan"
      ],
      "current_locations": [
        {
          "location": "San Francisco, California",
          "urls": ["https://www.forbes.com/profile/garry-tan/"]
        }
      ],
      "tagline": "President and CEO of Y Combinator, entrepreneur, and investor"
    },
    "employment": [
      {
        "company_name": "Y Combinator",
        "job_title": "President and CEO",
        "start_date": "2022",
        "end_date": null,
        "description": "Leads Y Combinator, the world's most successful startup accelerator, guiding strategy and operations for the organization that has funded over 4,000 startups.",
        "urls": ["https://www.ycombinator.com/people/garry-tan"]
      },
      {
        "company_name": "Initialized Capital",
        "job_title": "Co-Founder and Board Partner",
        "start_date": "2011",
        "end_date": null,
        "description": "Co-founded early-stage venture capital firm with Alexis Ohanian, investing in companies like Coinbase, Instacart, and Flexport.",
        "urls": ["https://initialized.com/"]
      },
      {
        "company_name": "Y Combinator",
        "job_title": "Partner",
        "start_date": "2011",
        "end_date": "2015",
        "description": "Served as a YC partner, mentoring and investing in early-stage startups."
      },
      {
        "company_name": "Palantir Technologies",
        "job_title": "Early Employee, Designer & Engineer",
        "start_date": "2008",
        "end_date": "2008",
        "description": "Early employee contributing to design and engineering on the founding team."
      }
    ],
    "education": [
      {
        "university_name": "Stanford University",
        "degree": "B.S. Computer Systems Engineering",
        "end_date": "2003",
        "description": "Studied computer systems engineering at Stanford University."
      }
    ],
    "projects": [
      {
        "title": "Posthaven",
        "description": "Continuation of Posterous as a sustainable blogging platform after the Twitter acquisition.",
        "start_date": "2013"
      },
      {
        "title": "Garry Tan YouTube Channel",
        "description": "Educational content for founders on product, hiring, and fundraising.",
        "start_date": "2020"
      }
    ],
    "summary": {
      "text": "Garry Tan is a prominent Silicon Valley entrepreneur, investor, and the current President and CEO of Y Combinator. He has played a pivotal role in shaping the startup ecosystem through his work at YC and as co-founder of Initialized Capital, where he made early investments in companies that became worth over $100 billion combined.\n\nTan's career spans founding startups, venture investing, and startup mentorship. He was a founding team member at Palantir Technologies and co-founded Posterous. His deep technical background as an engineer and designer, combined with his investing experience, gives him a unique perspective on building and scaling startups.",
      "urls": [
        "https://www.ycombinator.com/people/garry-tan",
        "https://www.forbes.com/profile/garry-tan/",
        "https://x.com/garrytan"
      ]
    }
  }
}
Poll every 5-10 seconds. Research typically completes within 1-3 minutes. Status can be RUNNING, COMPLETED, FAILED, or FAILED_AMBIGUOUS.

Next Steps