> ## Documentation Index > Fetch the complete documentation index at: https://docs.suprsend.com/llms.txt > Use this file to discover all available pages before exploring further. # List Channel Variants > Retrieve all variants for a specific channel within a template. ## OpenAPI ````yaml GET /v2/{workspace}/template/{template_slug}/channel/{channel}/variant/ openapi: 3.1.1 info: title: SuprSend API description: APIs supported on suprsend platform version: 1.2.2 servers: - url: https://hub.suprsend.com security: - sec0: [] - BearerAuth: [] paths: /v2/{workspace}/template/{template_slug}/channel/{channel}/variant/: get: summary: List Channel Variants description: Retrieve all variants for a specific channel within a template. operationId: list-channel-variants-v2 parameters: - in: path name: workspace required: true schema: type: string description: Workspace slug. - in: path name: template_slug required: true schema: type: string description: Template slug. - in: path name: channel required: true schema: type: string enum: - email - sms - whatsapp - inbox - androidpush - iospush - webpush - slack - ms_teams description: Channel slug. responses: '200': description: Successfully retrieved channel variants content: application/json: schema: type: object properties: meta: type: object properties: count: type: integer limit: type: integer offset: type: integer results: type: array items: $ref: '#/components/schemas/TemplateVariant' example: meta: count: 2 limit: 10 offset: 0 results: - $schema: >- https://schema.suprsend.com/template/v2/variant_schema.json channel: email id: default tenant_id: null locale: en conditions: [] hash: >- dd176370a4b99c735e30f70bc98c61983671072c40db70750c3ada9e5edcabc1 needs_vendor_approval: false sysgen_template_name: null approval_status: auto_approved discard_comment: null approval_at: '2026-04-07T10:39:28.502737Z' has_error: false seq_no: 1 action: null created_at: '2026-04-07T10:39:28.510000Z' - $schema: >- https://schema.suprsend.com/template/v2/variant_schema.json channel: email id: spanish tenant_id: null locale: es conditions: [] hash: >- a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 needs_vendor_approval: false sysgen_template_name: null approval_status: auto_approved discard_comment: null approval_at: '2026-04-07T11:00:00.000000Z' has_error: false seq_no: 2 action: null created_at: '2026-04-07T11:00:00.000000Z' '401': $ref: '#/components/responses/AuthenticationError' '404': $ref: '#/components/responses/NotFoundError' security: - ServiceTokenAuth: [] servers: - url: https://management-api.suprsend.com x-codeSamples: - lang: cURL label: List Channel Variants source: > curl -X GET "https://management-api.suprsend.com/v2/{workspace}/template/{template_slug}/channel/{channel}/variant/" \ --header 'Authorization: ServiceToken ' components: schemas: TemplateVariant: type: object properties: $schema: type: string description: Schema URL for variant validation. example: https://schema.suprsend.com/template/v2/variant_schema.json channel: type: string description: Channel this variant belongs to. example: email id: type: string description: Variant identifier. example: default tenant_id: type: string nullable: true description: Tenant this variant is scoped to, or null for default. locale: type: string description: Locale code. example: en conditions: type: array description: Conditions for variant selection at send time. items: type: object hash: type: string description: Content hash for change detection. needs_vendor_approval: type: boolean description: Whether this variant requires vendor approval (SMS DLT, WhatsApp). sysgen_template_name: type: string nullable: true description: System-generated template name for vendor approval. approval_status: type: string enum: - auto_approved - pending - sent_for_approval - approved - rejected description: Current approval status of the variant. discard_comment: type: string nullable: true description: Reason provided when a variant is discarded. approval_at: type: string format: date-time nullable: true description: Timestamp when the variant was approved. has_error: type: boolean description: Whether the variant has validation errors. seq_no: type: integer description: Ordering within the channel + tenant + locale combination. action: type: string nullable: true description: >- Action taken in the latest commit (Updated, Added, Unchanged, or null). created_at: type: string format: date-time description: Timestamp when the variant was created. content: type: object description: >- Channel-specific content. Structure varies by channel. Only returned in variant detail endpoint. vendor_approvals: type: array description: >- Vendor approval entries (WhatsApp/SMS only). Only returned in variant detail endpoint. items: type: object ErrorResponse: type: object properties: code: type: integer description: HTTP status code error_code: type: string description: Specific error code identifier type: type: string description: Error type classification message: type: string description: Human-readable error message detail: type: string description: Additional error details responses: AuthenticationError: description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 error_code: authentication_failed type: AuthenticationFailed message: Invalid service token. detail: Invalid service token. NotFoundError: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 404 error_code: not_found type: NotFound message: workspace 'demo' not found detail: workspace 'demo' not found securitySchemes: sec0: type: apiKey in: header name: Authorization x-bearer-format: bearer description: >- Bearer authentication header of the form `Bearer `, where is your auth token. BearerAuth: type: http scheme: bearer bearerFormat: API_Key description: >- Pass as `Bearer `. Get API Key from SuprSend dashboard Developers -> API Keys section. ServiceTokenAuth: type: apiKey in: header name: ServiceToken description: >- You can get Service Token from [SuprSend dashboard -> Account Settings -> Service Tokens](https://app.suprsend.com/en/account-settings/service-tokens) section. ````