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

# GET /v1/survey_assignments — List Survey Assignments

> Retrieve all historical survey-to-employee assignments from Honestly. See which employees were assigned to which surveys, and when they were assigned or unassigned.

The `/v1/survey_assignments` endpoint returns a paginated list of all historical, direct individual assignments of employees to surveys.

## Endpoint

```
GET https://api.honestly.com/v1/survey_assignments
```

## Query Parameters

<ParamField query="limit" type="integer">
  Maximum number of assignments to return per page. Accepts values from `0` to `1000`. Defaults to `100`.
</ParamField>

<ParamField query="offset" type="integer">
  Number of assignments to skip before returning results. Defaults to `0`.
</ParamField>

<ParamField query="survey_id" type="integer">
  Return only the assignments that belong to this survey. Omit to return assignments across all surveys.
</ParamField>

## Example Request

```bash theme={null}
curl -X GET "https://api.honestly.com/v1/survey_assignments?limit=200&offset=0" \
  -H "X-Api-Key: YOUR_SECRET_API_KEY"
```

## Example Response

```json theme={null}
{
  "total_count": 2,
  "survey_assignments": [
    {
      "id": 1,
      "survey_id": 23,
      "created_at": "2024-01-01T00:00:00Z",
      "deleted_at": null,
      "employee_id": 1
    },
    {
      "id": 2,
      "survey_id": 23,
      "created_at": "2024-01-01T00:00:00Z",
      "deleted_at": "2024-03-15T00:00:00Z",
      "employee_id": 2
    }
  ]
}
```

## Response Fields

<ResponseField name="total_count" type="integer">
  The total number of survey assignment records, across all pages.
</ResponseField>

<ResponseField name="survey_assignments" type="array">
  A paginated list of survey assignment objects.

  <Expandable title="survey assignment object fields">
    <ResponseField name="id" type="integer">
      Unique identifier for the survey assignment.
    </ResponseField>

    <ResponseField name="survey_id" type="integer">
      The survey this assignment belongs to.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      RFC 3339 datetime at which the employee was assigned to the survey.
    </ResponseField>

    <ResponseField name="deleted_at" type="string | null">
      RFC 3339 datetime at which the employee was unassigned from the survey. `null` when the assignment is still active.
    </ResponseField>

    <ResponseField name="employee_id" type="integer">
      The unique identifier of the assigned employee.
    </ResponseField>
  </Expandable>
</ResponseField>

<Tip>
  Join survey assignments with the [employees](/developers/api-reference/employees) and [surveys](/developers/api-reference/surveys) endpoints using `employee_id` and `survey_id` to build a complete picture of participation in your data warehouse.
</Tip>