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

# List AlimTalk templates

> List AlimTalk templates in template code order for a channel on the `Notifly` KakaoTalk platform. Use the template details endpoint to read the message body.



## OpenAPI

````yaml /en/api-reference/openapi.yaml get /v1/projects/{projectId}/messages/kakao-alimtalk/templates
openapi: 3.0.3
info:
  title: Notifly API
  version: 1.0.0
  contact:
    email: contact@notifly.tech
servers:
  - url: https://api.notifly.tech
    description: Notifly API server
security: []
tags:
  - name: catalog
    x-group: Catalogs
paths:
  /v1/projects/{projectId}/messages/kakao-alimtalk/templates:
    get:
      summary: list-kakao-bizmessage-alimtalk-templates
      operationId: listKakaoBizmessageAlimtalkTemplates
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: Project ID.
        - name: sender_channel_id
          in: query
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
          description: >-
            Kakao channel ID registered in the project. The channel must use the
            `Notifly` KakaoTalk platform. For `Notifly (Legacy)`, use the legacy
            endpoint to list templates.
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - registered
              - requested
              - approved
              - rejected
          description: >-
            Review status. Use `registered` for templates registered but not yet
            submitted for review, `requested` for templates under review,
            `approved` for approved templates, and `rejected` for rejected
            templates. Omit to include all statuses.
        - name: template_name
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 200
          description: >-
            Match part of the template name. Percent signs, underscores, and
            backslashes are treated literally.
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          description: Number of records to retrieve.
        - name: next_cursor
          in: query
          required: false
          schema:
            type: string
          description: The `next_cursor` value from the previous response.
      responses:
        '200':
          description: The template list was retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KakaoAlimtalkTemplateListResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotiflyV1ErrorResponse'
        '401':
          description: Authentication failed because the token is invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotiflyV1ErrorResponse'
        '403':
          description: Access to the project is denied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotiflyV1ErrorResponse'
        '404':
          description: The project or Kakao channel was not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotiflyV1ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    KakaoAlimtalkTemplateListResponse:
      type: object
      required:
        - data
        - error
      properties:
        data:
          type: object
          required:
            - sender_channel_id
            - templates
            - next_cursor
          properties:
            sender_channel_id:
              type: string
            templates:
              type: array
              items:
                type: object
                properties:
                  template_code:
                    type: string
                  template_name:
                    type: string
                  template_message_type:
                    type: string
                    nullable: true
                  template_emphasize_type:
                    type: string
                    nullable: true
                  status:
                    type: string
                    enum:
                      - registered
                      - requested
                      - approved
                      - rejected
            next_cursor:
              type: string
              nullable: true
              description: The cursor for the next page. `null` on the last page.
        error:
          nullable: true
          description: null on success.
    NotiflyV1ErrorResponse:
      type: object
      properties:
        data:
          type: object
          nullable: true
          description: null on failure.
        error:
          oneOf:
            - type: string
            - $ref: '#/components/schemas/NotiflyV1ErrorObject'
          description: >-
            Error returned by the v1 API. Authentication and authorization
            errors may be returned as an object with code and message fields.
            Request validation errors may be returned as a string.
      example:
        data: null
        error:
          code: UNAUTHORIZED
          message: Invalid Authorization Token
    NotiflyV1ErrorObject:
      type: object
      properties:
        code:
          type: string
          description: Error code.
        message:
          type: string
          description: Error message.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Pass the token issued by `POST /authenticate` as a bearer token.

````

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