API Reference

Authentication

All API requests require authentication using an API key:

curl -X GET "https://api.chatmaxima.com/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY"

Base URL

https://api.chatmaxima.com/v1

Endpoints

Contacts

List Contacts

GET /contacts

Parameters:

Name	Type	Description
page	integer	Page number
limit	integer	Items per page (max 100)
search	string	Search by name or phone

Response:

{
  "data": [
    {
      "id": "contact_123",
      "name": "John Doe",
      "phone": "+1234567890",
      "email": "john@example.com"
    }
  ],
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 20
  }
}

Messages

Send Message

POST /messages

Body:

{
  "contact_id": "contact_123",
  "channel": "whatsapp",
  "type": "text",
  "content": {
    "text": "Hello from API\!"
  }
}

Rate Limits

• Standard: 100 requests/minute
• Pro: 500 requests/minute
• Enterprise: Custom limits

Error Codes

Code	Description
400	Bad Request
401	Unauthorized
404	Not Found
429	Rate Limited
500	Server Error