---
title: "jobTemplate.list"
method: POST
path: "/jobTemplate.list"
tags: ["Job Template"]
---

# jobTemplate.list

`POST /jobTemplate.list`

List all active and inactive job templates.

See the [Pagination and Incremental Synchronization](/docs/pagination-and-incremental-sync) guide for detailed usage examples.

**Requires the [`jobsRead`](authentication#permissions-jobtemplatelist) permission.**

## Request body

- JobTemplateListRequest
  - `cursor` string, nullable — The pagination cursor. Use 'start' for the first page or the nextCursor value from a previous response.
  - `limit` integer, nullable — The maximum number of job templates to return per page. Maximum is 100.
  - `syncToken` string, nullable — A sync token to retrieve only job templates updated since the last sync. Obtained from a previous list response.
  - `expand` string[], nullable — Expand the result with related objects. Supported values are `location`.

## Response `200`

Responses from the jobTemplate.list endpoint

- union
  - JobTemplateListSuccessResponse
    - `success` true, required
    - `results` JobTemplate[], required
      - `id` string, uuid, required — The job template's unique identifier
      - `title` string, required — The title of the job template
      - `status` 'Active' | 'Inactive', required
      - `locationId` string, uuid — The id of the location of the job template
      - `departmentId` string, uuid — The id of the department or team associated with the job template
      - `defaultInterviewPlanId` string, uuid — The id of the default interview plan for this job template. A job cannot be opened without a default interview plan.
      - `interviewPlanIds` string[] — The ids of all interview plans associated with the job template
      - `location` Location
        - `id` string, uuid, required — The unique identifier for the location
        - `name` string, required — The name of the location
        - `externalName` string, nullable, required — An alternate candidate-facing name for this location used on job boards and in the API
        - `isArchived` boolean, required — Whether the location is archived
        - `isRemote` boolean, nullable, required — Deprecated. Use workplaceType instead.
        - `address` object, nullable, required — The address for the location
          - `postalAddress` object, required — The postal address for the location
            - `addressCountry` string — The country for the location address
            - `addressRegion` string — The region for the location address
            - `addressLocality` string — The locality for the location address
            - `postalCode` string — The postal code for the location address
            - `streetAddress` string — The street address for the location
        - `parentLocationId` string, uuid, nullable, required — The unique identifier for the parent location hierarchy, if any
        - `type` 'Location' | 'LocationHierarchy', required — The type of the location component
        - `workplaceType` 'OnSite' | 'Hybrid' | 'Remote', nullable, required — The type of workplace
        - `extraData` object, nullable, required — Structured key-value information for your own use and reference. Do not store personally identifiable information in this field.
      - `createdAt` string, date-time, required — The timestamp when the job template was created
      - `updatedAt` string, date-time, required — The timestamp when the job template was last updated
    - `nextCursor` string — Cursor for the next page of results, if available
    - `moreDataAvailable` boolean — Whether more data is available beyond this page
    - `syncToken` string — Sync token to use for future incremental syncs. Only present on the last page.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)