---
title: "Listar contratos"
method: GET
path: "/contracts"
tags: ["Contratos"]
---

# Listar contratos

`GET /contracts`

Lista os contratos que existem na sua organização.

> Os valores dos campos `rider_tax`, `rider_value` e `total_value` serão exibidos apenas para usuários com a permissão <span style="white-space: nowrap; margin:1px; padding:1px 8px; font-weight:bold; border-radius:12px;  background-color: var(--light-red, var(--input-bg)); color:var(--red); border:1px solid var(--red)"><!--?lit$8458964218$-->Visualizar valores dos tickets</span>. Caso o usuário não possua esta permissão, esses campos retornarão `"--"` na resposta.

## Query parameters

- `offset` integer
- `limit` integer
- `client_ids` integer[]
- `contract_type_ids` integer[]
- `status` string[]

## Response `200`

- object[]
  - `id` number, required — Identificador do contrato
  - `cancelled` boolean, required — Indica se o contrato está cancelado ou com cancelamento agendado
  - `client` object, required — Objeto contendo informações sobre o cliente associado ao contrato
    - `id` number, required — Identificador do cliente
    - `name` string, required — Nome do cliente
  - `contract_type` object, required — Objeto contendo informações sobre o tipo de contrato
    - `id` number, required — Identificador do tipo de contrato
    - `name` string, required — Nome do tipo de contrato
  - `duration` number, nullable, required — Duração do contrato em meses. Presente apenas se determinado um prazo de expiração do contrato
  - `expiration_date` string, nullable, required — Data de expiração do contrato
  - `modality` 'Free' | 'Credit' | 'Shared' | 'Hours' | 'Saas/Product' | 'Per ticket' | 'Cumulative Hours', required — Modalidade
  - `name` string, required — Nome do contrato
  - `readjust_duration` number, nullable, required — Intervalo (em meses) para reajuste do contrato. Presente apenas se o contrato tiver reajuste de valores
  - `readjustment_date` string, nullable, required — Data de reajuste do contrato, se aplicável
  - `rider_tax` string, required — Utilizado em contratos de crédito. Esse é o valor fixo mensal à ser pago pelo contrato. Este valor informado não é usado como crédito mensal para abater das horas trabalhadas.
  - `rider_value` string, required — Valor do último adendo
  - `status` 'actives' | 'readjust' | 'expired', required — Status ou situação em que o contrato se encontra: * `actives`: Ativo * `readjust`: Pendente de reajuste * `expired`: Inativo
  - `total_value` string, required — Valor total do contrato: valor do último adendo (rider_value) + valor fixo mensal (rider_tax)

## Other responses

- `403` — ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `422` — ### **Problemas com algum atributo informado**

---

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