GET /v1/projects/4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b
Authorization: Bearer <api_key>
{
"id": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b",
"name": "Q4 IT security buyer interviews",
"status": "ACTIVE",
"description": "Directors and VPs at US companies who own or influence cybersecurity tooling decisions.",
"contactEmail": "research-ops@partner.com",
"audience": "CYBERSECURITY_PROFESSIONALS",
"studyType": "AI_MODERATED_INTERVIEW",
"loiMinutes": 30,
"incidenceRate": 30,
"filters": {
"countries": ["US"],
"seniorities": ["DIRECTOR", "VP"]
},
"targetNSize": 20,
"completes": 8,
"pauseAtTarget": true,
"cpi": { "amount": 120.00, "currency": "USD" },
"estimatedCost": { "amount": 2400.00, "currency": "USD" },
"entryUrl": "https://interviews.partner.com/session/xyz?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"redirectUrls": {
"complete": "https://app.emporiaresearch.com/survey/interviewcomplete?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"quotaFull": "https://app.emporiaresearch.com/survey/quotafull?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"terminated": "https://app.emporiaresearch.com/survey/terminated?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"qualityRejected": "https://app.emporiaresearch.com/survey/qualityrejected?uid=REPLACE_ME_WITH_RESPONDENT_ID"
},
"attachments": [
{
"id": "b7d2e9a4c1f84b3e8a6d5c2f9e1a7b4d",
"type": "SCREENER",
"fileName": "screener.pdf",
"contentType": "application/pdf",
"sizeBytes": 184320,
"createdAt": "2026-10-27T16:24:03.551207Z"
}
],
"testRespondentIds": ["5c8e2a7f1b3d4e9a8c6f2b4d7e1a3c9f", "8a4d1f6c3e9b4a7d9c2e5f8b1a4d7c3e"],
"createdAt": "2026-10-27T16:20:11.482913Z",
"updatedAt": "2026-10-29T11:03:52.917204Z"
}
Projects
Get a project
Look up a project by ID.
GET /v1/projects/4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b
Authorization: Bearer <api_key>
{
"id": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b",
"name": "Q4 IT security buyer interviews",
"status": "ACTIVE",
"description": "Directors and VPs at US companies who own or influence cybersecurity tooling decisions.",
"contactEmail": "research-ops@partner.com",
"audience": "CYBERSECURITY_PROFESSIONALS",
"studyType": "AI_MODERATED_INTERVIEW",
"loiMinutes": 30,
"incidenceRate": 30,
"filters": {
"countries": ["US"],
"seniorities": ["DIRECTOR", "VP"]
},
"targetNSize": 20,
"completes": 8,
"pauseAtTarget": true,
"cpi": { "amount": 120.00, "currency": "USD" },
"estimatedCost": { "amount": 2400.00, "currency": "USD" },
"entryUrl": "https://interviews.partner.com/session/xyz?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"redirectUrls": {
"complete": "https://app.emporiaresearch.com/survey/interviewcomplete?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"quotaFull": "https://app.emporiaresearch.com/survey/quotafull?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"terminated": "https://app.emporiaresearch.com/survey/terminated?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"qualityRejected": "https://app.emporiaresearch.com/survey/qualityrejected?uid=REPLACE_ME_WITH_RESPONDENT_ID"
},
"attachments": [
{
"id": "b7d2e9a4c1f84b3e8a6d5c2f9e1a7b4d",
"type": "SCREENER",
"fileName": "screener.pdf",
"contentType": "application/pdf",
"sizeBytes": 184320,
"createdAt": "2026-10-27T16:24:03.551207Z"
}
],
"testRespondentIds": ["5c8e2a7f1b3d4e9a8c6f2b4d7e1a3c9f", "8a4d1f6c3e9b4a7d9c2e5f8b1a4d7c3e"],
"createdAt": "2026-10-27T16:20:11.482913Z",
"updatedAt": "2026-10-29T11:03:52.917204Z"
}
Returns a project.
Path parameters
string
required
Project ID.
Response
Returns the same fields as Create a project, plus:integer
required
Respondents with status
COMPLETED. Scrubbed and test respondents don’t count.object[]
required
Files uploaded with Upload an attachment.
Errors
General errors are listed in the Overview.| Status | Code | When |
|---|---|---|
| 404 | PROJECT_NOT_FOUND | No project with this ID exists for your account. |
GET /v1/projects/4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b
Authorization: Bearer <api_key>
{
"id": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b",
"name": "Q4 IT security buyer interviews",
"status": "ACTIVE",
"description": "Directors and VPs at US companies who own or influence cybersecurity tooling decisions.",
"contactEmail": "research-ops@partner.com",
"audience": "CYBERSECURITY_PROFESSIONALS",
"studyType": "AI_MODERATED_INTERVIEW",
"loiMinutes": 30,
"incidenceRate": 30,
"filters": {
"countries": ["US"],
"seniorities": ["DIRECTOR", "VP"]
},
"targetNSize": 20,
"completes": 8,
"pauseAtTarget": true,
"cpi": { "amount": 120.00, "currency": "USD" },
"estimatedCost": { "amount": 2400.00, "currency": "USD" },
"entryUrl": "https://interviews.partner.com/session/xyz?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"redirectUrls": {
"complete": "https://app.emporiaresearch.com/survey/interviewcomplete?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"quotaFull": "https://app.emporiaresearch.com/survey/quotafull?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"terminated": "https://app.emporiaresearch.com/survey/terminated?uid=REPLACE_ME_WITH_RESPONDENT_ID",
"qualityRejected": "https://app.emporiaresearch.com/survey/qualityrejected?uid=REPLACE_ME_WITH_RESPONDENT_ID"
},
"attachments": [
{
"id": "b7d2e9a4c1f84b3e8a6d5c2f9e1a7b4d",
"type": "SCREENER",
"fileName": "screener.pdf",
"contentType": "application/pdf",
"sizeBytes": 184320,
"createdAt": "2026-10-27T16:24:03.551207Z"
}
],
"testRespondentIds": ["5c8e2a7f1b3d4e9a8c6f2b4d7e1a3c9f", "8a4d1f6c3e9b4a7d9c2e5f8b1a4d7c3e"],
"createdAt": "2026-10-27T16:20:11.482913Z",
"updatedAt": "2026-10-29T11:03:52.917204Z"
}