> ## 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.
# Get Variant Detail
> Retrieve detailed information about a specific variant including its content, conditions, and vendor approval status.
## OpenAPI
````yaml GET /v2/{workspace}/template/{template_slug}/channel/{channel}/variant/{variant_id}/
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/{variant_id}/:
get:
summary: Get Variant Detail
description: >-
Retrieve detailed information about a specific variant including its
content, conditions, and vendor approval status.
operationId: get-variant-v2
parameters:
- in: path
name: workspace
required: true
schema:
type: string
- in: path
name: template_slug
required: true
schema:
type: string
- in: path
name: channel
required: true
schema:
type: string
enum:
- email
- sms
- whatsapp
- inbox
- androidpush
- iospush
- webpush
- slack
- ms_teams
- in: path
name: variant_id
required: true
schema:
type: string
description: Variant identifier.
responses:
'200':
description: >-
Variant details retrieved. Includes full `content` and
`vendor_approvals` objects.
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateVariant'
example:
$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'
content:
$schema: >-
https://schema.suprsend.com/template/v2/channel/email_schema.json
templating_language: handlebars
from_name: Acme Store
from_address: noreply@acme-store.com
extra_to: ''
cc: ''
bcc: ''
reply_to: ''
subject: 'Order Confirmed - #{{order.number}}'
body:
type: raw
raw:
html: >-
Order Confirmed!
Hi
{{customer.name}}, your order #{{order.number}} has been
confirmed.
Total:
{{order.total}}
text: >-
Hi {{customer.name}}, your order #{{order.number}} has
been confirmed. Total: {{order.total}}
designer:
html: ...
text: ...
design_json: {}
display_conditions: []
preheader: 'Your order #{{order.number}} is confirmed'
plain_text: null
email_markup: ''
errors: {}
vendor_approvals: []
has_error: false
seq_no: 1
action: null
created_at: '2026-04-07T10:39:28.510000Z'
'401':
$ref: '#/components/responses/AuthenticationError'
'404':
$ref: '#/components/responses/NotFoundError'
security:
- ServiceTokenAuth: []
servers:
- url: https://management-api.suprsend.com
x-codeSamples:
- lang: cURL
label: Get Variant
source: >
curl -X GET
"https://management-api.suprsend.com/v2/{workspace}/template/{template_slug}/channel/{channel}/variant/{variant_id}/"
\
--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.
````