---
title: "Get Research"
method: GET
path: "/v1/research/{research_id}"
---

# Get Research

`GET /v1/research/{research_id}`

## Request

- Base URL: `https://api.happenstance.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.happenstance.ai/v1/research/{research_id}`
- Auth: HTTP bearer

Get the status of a research request.

## Path parameters

- `research_id` string, required

## Response `200`

Successful Response

- GetResearchResponseV1: Response from GET /v1/research/{id} - retrieving research status and results.
  - `id` string, required: Unique identifier for the research job
  - `status` string, required: Status of the research job (RUNNING, COMPLETED, FAILED, FAILED_AMBIGUOUS)
  - `query` string, required: Original research query
  - `created_at` string, required: Timestamp when research was created (ISO 8601 format)
  - `updated_at` string, required: Timestamp when research was last updated (ISO 8601 format)
  - `profile` ProfileV1: Complete profile of a researched person
    - `person_metadata` PersonMetadataV1: Metadata about a person
      - `full_name` string, nullable: Primary full name of the person
      - `alternate_names` string[], nullable: List of alternate names, nicknames, or aliases
      - `profile_urls` string[], nullable: URLs to online profiles (LinkedIn, Twitter, etc.)
      - `current_locations` CurrentLocationV1[], nullable: Current location(s) of the person
        - `location` string, required: Location name (e.g., 'Palo Alto, California')
        - `comments` string, nullable: Notes or context about the location
        - `urls` string[], nullable: URLs confirming this location
      - `tagline` string, nullable: Professional tagline or headline
    - `employment` EmploymentV1[], nullable: Employment history
      - `company_name` string, nullable: Name of the company
      - `job_title` string, nullable: Job title or role
      - `start_date` string, nullable: Start date (YYYY-MM-DD format)
      - `end_date` string, nullable: End date (YYYY-MM-DD format), null if current position
      - `description` string, nullable: Description of role and responsibilities
      - `urls` string[], nullable: Related URLs (company website, LinkedIn, etc.)
    - `education` EducationV1[], nullable: Education history
      - `university_name` string, nullable: Name of the university or institution
      - `degree` string, nullable: Degree obtained (e.g., BS, MS, PhD)
      - `start_date` string, nullable: Start date (YYYY-MM-DD format)
      - `end_date` string, nullable: End date (YYYY-MM-DD format)
      - `description` string, nullable: Additional details about the education
      - `urls` string[], nullable: Related URLs
    - `projects` ProjectV1[], nullable: Projects and achievements
      - `title` string, nullable: Title of the project
      - `description` string, nullable: Description of the project and achievements
      - `start_date` string, nullable: Start date (YYYY-MM-DD format)
      - `end_date` string, nullable: End date (YYYY-MM-DD format)
      - `urls` string[], nullable: Related URLs (project website, GitHub, etc.)
    - `writings` WritingV1[], nullable: Writings and publications
      - `title` string, nullable: Title of the writing or publication
      - `description` string, nullable: Summary or description of the content
      - `date` string, nullable: Publication date (YYYY-MM-DD format)
      - `urls` string[], nullable: URLs to the publication
    - `hobbies` HobbyV1[], nullable: Hobbies and personal interests
      - `description` string, nullable: Description of the hobby or interest
      - `urls` string[], nullable: Related URLs (blog, portfolio, etc.)
    - `summary` SummaryV1: Comprehensive summary of the person's profile
      - `text` string, required: Combined summary text
      - `urls` string[], nullable: Deduplicated URLs supporting the summary

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `410`: Gone
- `422`: Validation Error
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-15** `e9fa1fac093b`: 1 info
  - the endpoint scheme security `HTTPBearer` was added to the API

[Operation history](https://skmtc.dev/happenstance/apis/happenstance-api/changes/v1/research/:research_id/get.md)

---

[API](https://skmtc.dev/happenstance/apis/happenstance-api.md) - [All operations](https://skmtc.dev/happenstance/apis/happenstance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/happenstance/apis/happenstance-api/revisions/0b6ee3927db3?raw)