REST API v1

API Documentation

Read clients, projects, tasks, and invoices over a Bearer-token REST API. Generate keys from Settings → Developer.

Base URL: https://www.client-flow.in

Endpoints

GET
/api/v1/clients

List all clients in the organization with pagination.

POST
/api/v1/clients

Create a new client record. Plan limits are enforced server-side.

GET
/api/v1/projects

List projects with optional client and status filters.

POST
/api/v1/projects

Create a new project. Plan limits are enforced server-side.

GET
/api/v1/tasks

List tasks with status, assignee, and project filters.

POST
/api/v1/tasks

Create a new task. Counts against the monthly task-creation limit on metered plans.

GET
/api/v1/invoices

List invoices for the organization with status filters.

Features

API Keys

Generate and rotate organization-scoped API keys from Settings → Developer. Pass as a Bearer token.

RESTful Design

Predictable resource URLs, standard HTTP verbs, and JSON request and response bodies.

Rate Limiting

Per-key sliding-window limits. Quota and reset windows are returned in standard X-RateLimit-* headers.

Idempotency

Pass an Idempotency-Key header on POST requests to safely retry without creating duplicates.