MercLino API

Build with Merclino

Integrate appointments, customers, products, invoices, and more into your applications. RESTful API with JSON responses, API key authentication, and webhook support.

API Key Auth

Rate Limited

Webhooks

Base URL

https://merclino.com/api/v2

Authentication

All requests require a Bearer token in the Authorization header. Generate API keys from Settings → Integrations → API in your Merclino dashboard.

Header

Authorization: Bearer mk_live_your_api_key_here

Live Keysmk_live_

Full read/write access. Use in production.

Sandbox Keysmk_sand_

Read-only access. Safe for testing.

Quick Start

curl -X GET "https://merclino.com/api/v2/customers?page=1&limit=10" \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Format

Successful response

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 142,
    "totalPages": 3
  }
}

Error response

{
  "error": {
    "message": "Missing required scopes: customers:write",
    "code": "insufficient_scopes",
    "status": 403
  }
}

Rate Limits

Default: 100 requests/minute per API key. Higher limits available on Enterprise plans.

Header	Description
`X-RateLimit-Limit`	Max requests per window
`X-RateLimit-Remaining`	Remaining requests
`Retry-After`	Seconds until window resets (on 429)