Skip to main content
Clevis Payroll API is a stateless computation engine for Latin American payroll. Send employee data, receive an itemized breakdown with a step-by-step audit trail.

​
Get started

Quickstart

Calculate your first payroll in 5 minutes.

Authentication

Set up your API key.

API Reference

Explore all endpoints.

Error Handling

Handle errors gracefully.

​
Supported countries

CountrySchemesStatus
Mexicoordinario, asimiladosActive (2024-2026)
Colombiaordinario, integralActive (2025-2026)
ArgentinaordinarioActive (2025)

​
Key concepts

  • Scheme — A country-specific payroll ruleset (e.g., Mexico ordinario, Colombia integral). Use GET /v1/payroll/schemes/{country} to discover available schemes.
  • Calculation — A single employee payroll run for one period.
  • Audit trail — A step-by-step trace of every formula evaluated. Required for legal compliance in most Latin American countries.
  • Decimal precision — All monetary amounts are returned as JSON strings (not numbers) to prevent floating-point precision loss. Parse them with your language’s Decimal type before doing arithmetic.

​
Base URL

https://api.clevis.dev/v1

​
How it works

1

Send employee data

POST to /v1/payroll/calculate with salary, period, and country/scheme.
2

Engine computes

The engine resolves brackets, deductions, contributions, and exemptions using country-specific tax rules.
3

Get results

Receive itemized perceptions, deductions, employer costs, and a full audit trail. All monetary values as strings for precision.