> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emporiaresearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a project

> Look up a project by ID.

Returns a project.

## Path parameters

**id** `string` *required*

Project ID.

## Response

Returns the same fields as [Create a project](https://docs.emporiaresearch.com/demand-api/create-project.md), plus:

**completes** `integer` *required*

Respondents with status `COMPLETED`. Scrubbed and test respondents don't count.

**attachments** `object[]` *required*

Files uploaded with [Upload an attachment](https://docs.emporiaresearch.com/demand-api/upload-attachment.md).

## Errors

General errors are listed in the [Overview](https://docs.emporiaresearch.com/demand-api/overview.md#errors).

| Status | Code | When |
| - | - | - |
| 404 | `PROJECT_NOT_FOUND` | No project with this ID exists for your account. |

```http Request theme={null}
GET /v1/projects/4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b
Authorization: Bearer <api_key>
```

```json 200 theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.