API Documentation
← All tools
GET
/api/v1/researchers/:authorIdResearcher Profile
researchersNo success wrapper
Profile document for a researcher (principal investigator) resolved to an OpenAlex author. Use trial documents or pi_author_id results from the registry search to obtain an author id. The author id must come from a real source - there is no name-to-id resolution, so never invent one; invalid id formats return HTTP 400 and an id not in the resolved-researcher registry returns HTTP 404.
When to use it
- profile for a principal investigator
- metadata for an OpenAlex author id
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Parameters
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| authorId(path) | string | Yes | OpenAlex author id; prefer the flat forms A5027151969 or openalex_A5027151969 (the https URL form is accepted but gets URL-encoded on the wire). |
Query parameters
No parameters.
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/researchers/{authorId}"Response envelope
This endpoint returns an implicit 2xx response - there is no success flag in the body.
{
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}
// No "success" flag on this endpoint - any 2xx JSON is a success.Response shape
Single-object responseRESEARCHERS
Empty results: No record found (HTTP 404)
Catalog version 0.0.0-generated · generated from the API source