---
title: "/surveys/templates"
method: GET
path: "/surveys/templates"
---

# /surveys/templates

`GET /surveys/templates`

## Request

- Base URL: `https://subdomain.workable.com/spi/v3`
- URL: `https://subdomain.workable.com/spi/v3/surveys/templates`
- Auth: API key in header `Authorization`

Returns the account's survey master templates. Required scope: `r_surveys`. Requires a user token whose member has permission to view survey cycles, or an account token with the `member_id` of such a member; an account token without `member_id` gets `403`. The account must have the Surveys feature enabled.

Only the latest, non-deleted master templates in the `survey` category are returned. Pagination is optional via `limit` and `offset`; when omitted every template is returned.

## Query parameters

- `limit` integer
- `offset` integer
- `member_id` string

## Response `200`

200

- object
  - `total_count` integer
  - `templates` object[]
    - `id` string
    - `title` string
    - `updated_at` string, date-time: Omitted when unknown
    - `version` integer
    - `questionnaire` object
      - `sections` object[]
        - `id` string
        - `body` string
        - `questions` object[]
          - `id` string
          - `body` string
          - `type` 'paragraph' | 'paragraph_star_rated' | 'paragraph_numeric_rated' | 'paragraph_custom_rated' | 'single_choice' | 'multiple_choice' | 'star_rated' | 'numeric_rated' | 'custom_rated'
          - `metadata` object
            - `mandatory` boolean
            - `semantic_type` 'section_rating' | 'overall_rating'
            - `rating_options` object
            - `answer_options` object
              - …
            - `has_conditional_navigation` boolean
            - `navigation_config` object
              - …
    - `default` boolean
    - `sample` boolean
    - `disabled` boolean

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403

## Changes

- **2026-11-03** `13ad2e8e2ee9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/workable/apis/account-root/changes/surveys/templates/get.md)

---

[API](https://skmtc.dev/workable/apis/account-root.md) - [All operations](https://skmtc.dev/workable/apis/account-root/llms.txt) - [OpenAPI document](https://skmtc.dev/workable/apis/account-root/revisions/13ad2e8e2ee9?raw)