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

​
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

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