---
title: "Return a list of contracts."
method: GET
path: "/compensation/contracts"
tags: ["Compensation"]
---

# Return a list of contracts.

`GET /compensation/contracts`

This endpoint returns a paginated list of employment contracts. The URL params help to return more accurate results.

## Query parameters

- `contractTypeId` string
- `_userId` string
- `_companyId` string
- `offset` number
- `limit` number

## Headers

- `Authorization` string, required

## Response `200`

OK.

- object
  - `data` object[]
    - `_id` string — The Kenjo _id of the returned contracts.
    - `_userId` string — The employee id associated to the contract.
    - `_companyId` string — The company id associated to the contract.
    - `startDate` string — The start date of the contract in format YYYY-MM-DDThh:mm:ss.
    - `contractTypeId` string — The contract type id associated to the contract.
  - `metadata` object
    - `count` number — The number of rows retrieved according the pagination filters (limit + offset).
    - `offset` number — The number of pages to skip. Determines the page number when pagination is being used.
    - `limit` number — The maximum number of rows to retrieve. Determines the size of the page when pagination is being used.
    - `total` number — The total number of rows existing for the provided filters.

## Other responses

- `400` — BAD REQUEST. This is a wrong request in the client side due to invalid body or params.
- `401` — UNAUTHORIZED. The Authorization header is incorrect, not provided or the token expired.

---

[API](https://skmtc.net/kenjo/apis/kenjo-api.md) · [All operations](https://skmtc.net/kenjo/apis/kenjo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenjo/kenjo-api/revisions/58772b78268e/schema)