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

# Get Research

`GET /v1/research/{research_id}`

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

---

[API](https://skmtc.net/happenstance/apis/happenstance-api.md) · [All operations](https://skmtc.net/happenstance/apis/happenstance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/happenstance/happenstance-api/revisions/d5e1f45dc5e4/schema)