Viber Services

Retrieve available Viber services (brands) for your account.

List Viber Services

Get all Viber services available for creating templates.

GET /api/v1/viber-services

Response

[
  {
    "id": 12345,
    "brandName": "My Brand"
  },
  {
    "id": 12346,
    "brandName": "Another Brand"
  }
]

Response Fields

Field	Type	Description
id	integer	Viber service ID (use in templates)
brandName	string	Display name of the Viber brand

Example

cURL

curl -X GET https://api.transformify.mk/api/v1/viber-services \
  -H "X-API-Key: your-api-key"

JavaScript

const response = await fetch('https://api.transformify.mk/api/v1/viber-services', {
  headers: {
    'X-API-Key': 'your-api-key'
  }
});

const services = await response.json();
console.log(services);
// [{ id: 12345, brandName: 'My Brand' }, ...]

Python

import requests

response = requests.get(
    'https://api.transformify.mk/api/v1/viber-services',
    headers={'X-API-Key': 'your-api-key'}
)

services = response.json()
for service in services:
    print(f"ID: {service['id']}, Brand: {service['brandName']}")

Usage

When creating a Viber template, use the id from this endpoint as the viberServiceId:

{
  "name": "My Template",
  "messageType": 1,
  "templateContent": "Hello {{name}}!",
  "viberServiceId": 12345  // From viber-services endpoint
}

Notes

• Each company may have one or more Viber services
• Viber services represent your registered Viber Business accounts
• Messages sent through a template will appear from the associated brand

Errors

Status	Error	Description
401	Unauthorized	Invalid API key