> ## Documentation Index > Fetch the complete documentation index at: https://docs.clevis.dev/llms.txt > Use this file to discover all available pages before exploring further. # List stored calculations > Summaries, newest first, paginated by cursor. Ids are ULIDs, so ordering by id is ordering by time. Every version of a recalculated payroll is listed: filter by `employee_id` and the period to see the chain, where `is_superseded` marks the ones a later calculation replaced. ## OpenAPI ````yaml /openapi.json get /v1/payroll/calculations openapi: 3.1.0 info: title: Payroll API description: > ## Payroll Infrastructure API for Latin America **Stripe for payroll** — embedded payroll calculation infrastructure. ### Overview This API performs payroll calculations for Mexico, Colombia, Brazil, Argentina, and Chile. It is a **pure computation engine**: give it employee data, get back a fully itemized payroll breakdown. ### 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 in client languages. Parse them with your language's `Decimal` type before doing any arithmetic. ``` ✅ correct: {"net_salary": "20039.25"} ❌ wrong: {"net_salary": 20039.25} // could lose precision ``` ### Authentication All endpoints require a Bearer API key: ``` Authorization: Bearer your_api_key_here ``` ### Error format All errors follow a consistent structure: ```json { "error": { "code": "SCHEME_NOT_FOUND", "message": "Human-readable description", "details": {}, "request_id": "abc123" } } ``` Use the `code` field (not the HTTP status) for programmatic error handling. The `request_id` links to server logs — include it when contacting support. ### Payouts (mock provider) The `/v1/payouts` surface lets you pay an employee their `net_salary` after a calculation. In v1 every payout is handled by an **in-process mock provider** — no real funds are moved. Every response is marked with `mock: true` in the body and `X-Clevis-Mock: true` as a response header. - Magic `external_id` prefixes (`MOCK_REJECT_INTAKE_`, `MOCK_REJECT_BANK_`, `MOCK_SLOW_`, `MOCK_STUCK_`, `MOCK_OK_`) trigger deterministic outcomes for demos and tests. - `processing.step_seconds: 0` makes the payout transition to its terminal status synchronously before the response is returned. - Idempotency is supported via the `Idempotency-Key` header or via the `external_id` field (per API key). See `docs/specs/04_payout_mock_endpoint.md` for the full contract. The real dLocal integration will be a config flip behind the same interface; this client-facing contract does not change. contact: name: Payroll API Support email: api@payroll.io license: name: Proprietary version: 1.0.0 servers: [] security: [] tags: - name: Payroll description: Payroll calculation endpoints. All monetary values are JSON strings. - name: Payouts description: >- Single-beneficiary payout endpoints backed by an in-process **mock** provider in v1 — no real funds are moved. Every response carries `mock: true` and the `X-Clevis-Mock: true` header. Magic trigger values (e.g. `external_id` prefixed with `MOCK_REJECT_BANK_`) force deterministic outcomes for demos and tests. - name: Schemes & Health description: Discover available payroll schemes and check service health. - name: Health description: Service health and readiness checks. paths: /v1/payroll/calculations: get: tags: - Calculations summary: List stored calculations description: >- Summaries, newest first, paginated by cursor. Ids are ULIDs, so ordering by id is ordering by time. Every version of a recalculated payroll is listed: filter by `employee_id` and the period to see the chain, where `is_superseded` marks the ones a later calculation replaced. operationId: Calculations_list_calculations parameters: - name: employer_id in: query required: false schema: anyOf: - type: string - type: 'null' title: Employer Id - name: employee_id in: query required: false schema: anyOf: - type: string - type: 'null' title: Employee Id - name: country in: query required: false schema: anyOf: - type: string minLength: 2 maxLength: 2 - type: 'null' title: Country - name: batch_id in: query required: false schema: anyOf: - type: string - type: 'null' title: Batch Id - name: period_from in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Only periods starting on or after this date. title: Period From description: Only periods starting on or after this date. - name: period_to in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Only periods starting on or before this date. title: Period To description: Only periods starting on or before this date. - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 25 title: Limit - name: starting_after in: query required: false schema: anyOf: - type: string - type: 'null' description: 'Cursor: the id of the last item of the previous page.' title: Starting After description: 'Cursor: the id of the last item of the previous page.' responses: '200': description: A page of calculation summaries. content: application/json: schema: type: object additionalProperties: true title: Response Calculations List Calculations '401': description: Missing, invalid, revoked or wrong-environment API key. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - ApiKeyBearer: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyBearer: type: http description: >- API key authentication. Send your API key as: Authorization: Bearer scheme: bearer ````