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.

What you can do

  • Calculate payroll for a single employee or a batch — full perceptions, deductions, employer contributions, and audit trail
  • Simulate salary scenarios without persisting results — for quote/preview UIs and compensation planning
  • Pay an employee their net salary through a stable Payouts API (easy to test in sandbox, no real funds moved)

Get started

Quickstart

Calculate your first payroll in 5 minutes.

Pay a payroll

Calculate net salary, then pay it out end to end.

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-2026)
BrazilempregadoActive (2025-2026)
ChileordinarioActive (2025-2026)
PeruordinarioActive (2025-2026)

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.
4

Pay the net salary

POST to /v1/payouts with the net_salary from the previous step to pay the employee.