curl --url 'https://api.minerva.io/person-search/v0/search-jobs/8c2a6f71-3d41-4fc5-a2b6-1f53a5c81d77/results?limit=100&offset=0' \
--header 'x-api-key: <api-key>'
Async Person Search
Async Person Search Results
Page the matching PIDs from a completed full person search
GET
/
person-search
/
v0
/
search-jobs
/
{segment_id}
/
results
curl --url 'https://api.minerva.io/person-search/v0/search-jobs/8c2a6f71-3d41-4fc5-a2b6-1f53a5c81d77/results?limit=100&offset=0' \
--header 'x-api-key: <api-key>'
Returns a page of PIDs from a search submitted with
See the complete flow.
materialization_extent: "full" once its status is completed.
PID retrieval does not consume record capacity. Use
Enrich v2 to retrieve full profiles; record capacity
is consumed on delivery.
curl --url 'https://api.minerva.io/person-search/v0/search-jobs/8c2a6f71-3d41-4fc5-a2b6-1f53a5c81d77/results?limit=100&offset=0' \
--header 'x-api-key: <api-key>'
string
required
API key for the organization that submitted the search.
string
required
UUID returned when submitting the search.
integer
default:"100"
PIDs per page, from
1 to 100.integer
default:"0"
Number of PIDs to skip; must be zero or greater.
Response
{
"segment_id": "8c2a6f71-3d41-4fc5-a2b6-1f53a5c81d77",
"pids": ["pid_1", "pid_2"],
"total": 1250,
"returned": 2,
"limit": 2,
"offset": 0
}
total is the full result count; returned is the number of PIDs in this
page. Increase offset by returned until offset + returned >= total.
An offset at or beyond the end returns an empty page.
Errors
| Status | Meaning |
|---|---|
401 | Missing or invalid credentials |
403 | Organization lacks API access |
404 | Search does not exist or belongs to another organization |
409 | Full search results are not ready, including preview-only jobs |
422 | Invalid segment ID or pagination parameters |
503 | Search service unavailable |
Was this page helpful?