Skip to main content

Tiquo API

Build powerful integrations with the Tiquo REST API.

Overview

The Tiquo API provides programmatic access to:
  • Customers - Manage customer profiles and data
  • Orders - Create and manage bookings and sales
  • Services - Access service catalog
  • Products - Manage inventory
  • Locations - Location management
  • Analytics - Access business metrics

Base URL

All API requests use this base:
https://api.tiquo.co/v1

Authentication

All requests require authentication via API key:
Authorization: Bearer YOUR_API_KEY

API Keys

Create and manage API keys

Request Format

Content Type

JSON for all requests:
Content-Type: application/json

Request Example

curl -X POST https://api.tiquo.co/v1/customers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]"
  }'

Response Format

Success Response

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "Email is required",
    "field": "email"
  }
}

HTTP Status Codes

CodeMeaning
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Server Error

Rate Limiting

Limits

PlanLimit
Starter100 requests/min
Pro1,000 requests/min
Enterprise10,000 requests/min

Rate Limit Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1704110400

Handling Limits

When rate limited (429):
  1. Check X-RateLimit-Reset header
  2. Wait until reset time
  3. Implement exponential backoff

Pagination

List Endpoints

Use cursor-based pagination:
GET /v1/customers?limit=25&cursor=abc123

Parameters

ParameterDefaultMax
limit25100
cursor--

Response

{
  "success": true,
  "data": [...],
  "pagination": {
    "hasMore": true,
    "nextCursor": "xyz789"
  }
}

Filtering

Common Filters

GET /v1/[email protected]
GET /v1/orders?status=confirmed
GET /v1/orders?createdAfter=2024-01-01

Date Ranges

GET /v1/orders?createdAfter=2024-01-01&createdBefore=2024-02-01

SDKs

Official SDKs

JavaScript/TypeScript

npm install @tiquo/sdk

Python

pip install tiquo

SDK Example

import Tiquo from '@tiquo/sdk';

const tiquo = new Tiquo('YOUR_API_KEY');

const customers = await tiquo.customers.list({
  limit: 10
});

Webhooks

Receive real-time notifications:

Webhooks

Set up webhook endpoints

Versioning

API Versions

Current version: v1 Version is included in URL:
https://api.tiquo.co/v1/...

Version Policy

  • Backwards-compatible changes added without version bump
  • Breaking changes require new version
  • Deprecation notice before removal

Getting Help