OpenAPI Specification
openapi: 3.1.0
info:
title: WATI WhatsApp Business Contacts API
description: 'Tenant-scoped REST API for the WATI WhatsApp Business platform. Use this API
to send WhatsApp template and session messages, manage contacts, fetch
conversation history, and orchestrate operator assignments. Each WATI
workspace exposes its own base URL (for example,
`https://live-mt-server.wati.io/{tenantId}`) and authenticates calls with a
Bearer access token issued from the WATI dashboard.
'
version: 1.0.0
contact:
name: WATI Support
url: https://support.wati.io
license:
name: Proprietary
servers:
- url: https://live-mt-server.wati.io/{tenantId}/api/v1
description: WATI multi-tenant production server
variables:
tenantId:
default: '0'
description: WATI tenant / workspace identifier assigned to the account.
security:
- bearerAuth: []
tags:
- name: Contacts
description: Manage WhatsApp contacts in the WATI workspace.
paths:
/getContacts:
get:
tags:
- Contacts
summary: List contacts
description: Retrieve a paginated list of contacts in the WATI workspace.
operationId: getContacts
parameters:
- in: query
name: pageSize
schema:
type: integer
format: int32
default: 10
description: Number of contacts to return per page.
- in: query
name: pageNumber
schema:
type: integer
format: int32
default: 1
description: 1-based page number to retrieve.
responses:
'200':
description: A paginated list of contacts.
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'WATI uses Bearer token authentication. Tokens are issued from the WATI
dashboard under API Docs and must be supplied as
`Authorization: Bearer <token>` on every request.
'
externalDocs:
description: WATI API Reference
url: https://docs.wati.io/reference/introduction