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

# Sample sources

> List all the sample sources of a survey.

## List the sample sources

Retrieves all the sample sources of a survey.

```http theme={null}
GET /api/v1/surveys/{SURVEY_ID}/sample_sources
```

### Parameters

<ParamField path="SURVEY_ID" type="integer" required>
  The identifier of the survey.
</ParamField>

### Response fields

<ResponseField name="id" type="integer">
  ID of the record.
</ResponseField>

<ResponseField name="provider" type="string">
  Provider type of the sample source. Possible values:

  * `panel`
  * `client_sample`
  * `social_networks`
  * `data_import`
</ResponseField>

<ResponseField name="sample_size" type="integer">
  Target sample size for this source.
</ResponseField>

<ResponseField name="country_code" type="string">
  ISO 3166 country code, for example: `FR`.
</ResponseField>

<ResponseField name="description" type="string">
  Long description of the sample source.
</ResponseField>

<ResponseField name="name" type="string">
  Short description of the sample source.
</ResponseField>

<ResponseField name="hashid" type="string">
  Identifier of the sample source used in URLs.
</ResponseField>

<ResponseField name="panelist_id_required" type="boolean">
  Indicates whether the interviews created in this source must have a `panelist_id` to be valid.
</ResponseField>

<ResponseField name="created_at" type="string">
  Date and time in ISO 8601 format, with time-zone offset.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Date and time in ISO 8601 format, with time-zone offset.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "sample_sources": [
      {
        "id": 1234,
        "provider": "social_networks",
        "sample_size": 1000,
        "country_code": "FR",
        "description": "Parents aged 30+ with children aged 10-18",
        "name": "Meta - campaign XYZ",
        "hashid": "MBbQN6C7",
        "panelist_id_required": false,
        "created_at": "2025-07-21T10:50:17.725+02:00",
        "updated_at": "2025-07-21T10:50:17.725+02:00"
      }
    ],
    "pagination": {
      "current_page": 1,
      "next_page": null,
      "prev_page": null,
      "total_pages": 1,
      "total_count": 1
    }
  }
  ```
</ResponseExample>


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