> ## Documentation Index > Fetch the complete documentation index at: https://docs.modernloop.io/llms.txt > Use this file to discover all available pages before exploring further. # List templates > Returns paginated organization email and calendar templates with their content and send metadata. Combine IDs, template types, a case-insensitive name substring, and record timestamps to narrow results; every supplied filter is applied together. Use the cursor to continue the same filtered result set. **Beta**: this endpoint may change or be removed without notice while in beta. There is no compatibility promise until it reaches general availability. ## OpenAPI ````yaml /openapi.json get /v1/templates openapi: 3.1.0 info: title: ModernLoop Platform API version: 0.1.0 description: The ModernLoop Platform API for managing recruiting workflows. contact: email: support@modernloop.io servers: - url: https://api.modernloop.io security: [] tags: - name: Application - name: Candidate - name: Interview Event - name: Interview Module - name: Interviewer - name: Job - name: Job Stage - name: Organization - name: Schedule - name: Scheduling Task - name: Task Queue - name: Template paths: /v1/templates: get: tags: - Template summary: List templates description: >- Returns paginated organization email and calendar templates with their content and send metadata. Combine IDs, template types, a case-insensitive name substring, and record timestamps to narrow results; every supplied filter is applied together. Use the cursor to continue the same filtered result set. operationId: listTemplates parameters: - schema: type: string description: >- Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters. required: false description: >- Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters. name: cursor in: query - schema: type: integer minimum: 1 maximum: 100 default: 25 description: Page size. Must be between 1 and 100; defaults to 25. required: false description: Page size. Must be between 1 and 100; defaults to 25. name: limit in: query - schema: type: - array - 'null' items: type: string pattern: >- ^(?:tpl_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$ description: >- a template ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive. example: tpl_a1b2c3d4e5f64789a1b2c3d4e5f64789 description: Comma-separated list of IDs; maximum 100 values. required: false description: Comma-separated list of IDs; maximum 100 values. name: ids in: query style: form explode: false - schema: type: - array - 'null' items: type: string enum: - OTHER - CANDIDATE_AVAILABILITY_REQUEST - CANDIDATE_CONFIRMATION - CANDIDATE_INVITE - DEBRIEF_CALENDAR_INVITE - INTERVIEWER_INVITE - SLACK_CHANNEL_MESSAGE - DEBRIEF_CONFIRMATION_CONVERSATION_MESSAGE - DEBRIEF_UPDATE_CONFIRMATION_CONVERSATION_MESSAGE - DEBRIEF_UPDATE_CONFIRMATION_INTERVIEWER_CALENDAR_INVITE - SCHEDULE_CANCELLATION_CANDIDATE_EMAIL - SCHEDULE_CANCELLATION_INTERVIEWER_EMAIL - SCHEDULE_CANCELLATION_CONVERSATION_MESSAGE - SCHEDULE_UPDATE_CONFIRMATION_CANDIDATE_EMAIL - SCHEDULE_UPDATE_CONFIRMATION_CANDIDATE_INVITE - SCHEDULE_UPDATE_CONFIRMATION_INTERVIEWER_INVITE - SCHEDULE_UPDATE_CONFIRMATION_CONVERSATION_MESSAGE - SELF_SCHEDULE_REQUEST_CANDIDATE_EMAIL description: >- Matches templates with any listed type; combines with other filters using AND. required: false description: >- Matches templates with any listed type; combines with other filters using AND. name: types in: query style: form explode: false - schema: type: string description: >- Case-insensitive substring match on template name; combines with other filters using AND. required: false description: >- Case-insensitive substring match on template name; combines with other filters using AND. name: name in: query - schema: type: string format: date-time description: Filters records created at or after this timestamp. required: false description: Filters records created at or after this timestamp. name: created_at_gte in: query - schema: type: string format: date-time description: Filters records created at or before this timestamp. required: false description: Filters records created at or before this timestamp. name: created_at_lte in: query - schema: type: string format: date-time description: Filters records updated at or after this timestamp. required: false description: Filters records updated at or after this timestamp. name: updated_at_gte in: query - schema: type: string format: date-time description: Filters records updated at or before this timestamp. required: false description: Filters records updated at or before this timestamp. name: updated_at_lte in: query responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Template' pagination: $ref: '#/components/schemas/Pagination' required: - data - pagination '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '410': description: Gone content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: Template: type: object properties: id: type: string pattern: ^tpl_[0-9a-f]{32}$ description: >- Canonical template ID (tpl_ followed by 32 lowercase hexadecimal UUID characters). example: tpl_a1b2c3d4e5f64789a1b2c3d4e5f64789 name: type: string type: type: string enum: - OTHER - CANDIDATE_AVAILABILITY_REQUEST - CANDIDATE_CONFIRMATION - CANDIDATE_INVITE - DEBRIEF_CALENDAR_INVITE - INTERVIEWER_INVITE - SLACK_CHANNEL_MESSAGE - DEBRIEF_CONFIRMATION_CONVERSATION_MESSAGE - DEBRIEF_UPDATE_CONFIRMATION_CONVERSATION_MESSAGE - DEBRIEF_UPDATE_CONFIRMATION_INTERVIEWER_CALENDAR_INVITE - SCHEDULE_CANCELLATION_CANDIDATE_EMAIL - SCHEDULE_CANCELLATION_INTERVIEWER_EMAIL - SCHEDULE_CANCELLATION_CONVERSATION_MESSAGE - SCHEDULE_UPDATE_CONFIRMATION_CANDIDATE_EMAIL - SCHEDULE_UPDATE_CONFIRMATION_CANDIDATE_INVITE - SCHEDULE_UPDATE_CONFIRMATION_INTERVIEWER_INVITE - SCHEDULE_UPDATE_CONFIRMATION_CONVERSATION_MESSAGE - SELF_SCHEDULE_REQUEST_CANDIDATE_EMAIL subject: type: - string - 'null' is_organization_default: type: boolean created_at: type: string format: date-time description: ISO 8601 timestamp. updated_at: type: string format: date-time description: ISO 8601 timestamp. last_sent_at: type: - string - 'null' format: date-time description: ISO 8601 timestamp. required: - id - name - type - subject - is_organization_default - created_at - updated_at - last_sent_at Pagination: type: object properties: next_cursor: type: - string - 'null' required: - next_cursor ErrorResponse: type: object properties: error: type: object properties: code: type: string enum: - UNAUTHENTICATED - API_ACCESS_DISABLED - SCOPE_MISSING - INSUFFICIENT_SCOPE - VALIDATION_FAILED - INVALID_CURSOR - PAYLOAD_TOO_LARGE - NOT_FOUND - NOT_FOUND_MAY_BE_SYNCING - CANDIDATE_ANONYMIZED - TASK_STAGE_NOT_SCHEDULABLE - DUPLICATE_REQUEST_OPEN - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - PREVIEW_EXPIRED - PREVIEW_STALE - RATE_LIMITED - CONFLICT - NOT_IMPLEMENTED - INTERNAL - UPSTREAM_TIMEOUT message: type: string docs_url: type: string format: uri required: - code - message required: - error securitySchemes: bearerAuth: type: http scheme: bearer description: API tokens are passed as Bearer tokens. ````