---
title: "List all Contracts 🌍"
method: GET
path: "/companies/{companyId}/contracts"
tags: ["Contract"]
---

# List all Contracts 🌍

`GET /companies/{companyId}/contracts`

Returns all Contracts. This list is paginated.
\
**Required scopes**: *contracts:read*

## Path parameters

- `companyId` string, required

## Query parameters

- `nextPageToken` string
- `maxResults` string
- `includeInProgressContracts` string

## Response `200`

All active, pending and last year archived contracts

- object
  - `contracts` object[]
    - `standardWeeklyHours` number, nullable, required — Weekly hours defined in the contract. It will be available if `contracts:time-information:read` scope is set on the token.
    - `fullTimeEquivalent` number, nullable, required — Percentage of weekly hours in the contract. It will be available if `contracts:time-information:read` scope is set on the token.
    - `isFullTime` boolean, nullable, required — Will be set to `true` if `fullTimeEquivalent` is at 1. It will be available if `contracts:time-information:read` scope is set on the token.
    - `contractId` string, required — Id of the contract.
    - `companyId` string, required — Id of the contract's company.
    - `startDate` string, date, required — Contract start date.
    - `endDate` string, date, nullable — Contract end date.
    - `probationEndDate` string, date, nullable — Contract probation end date.
    - `jobName` string, nullable, required — Job name of the employee.
    - `status` 'ACTIVE' | 'ARCHIVED' | 'PENDING', required — Status of the contrat.
    - `collaboratorId` string, required — The id of the collaborator linked to the contract.
    - `firstName` string, required — Firstname of the employee. This field is deprecated, you should use the information on the collaborator entity instead.
    - `lastName` string, required — Lastname of the employee. This field is deprecated, you should use the information on the collaborator entity instead.
    - `birthName` string, required — Name given to the employee upon their birth. This field is deprecated, you should use the information on the collaborator entity instead.
    - `birthDate` string, date, nullable, required — Birth date of the employee. This field is deprecated, you should use the information on the collaborator entity instead.
    - `contactEmail` string, nullable — The contact email of the contract. This email is not guaranteed to be a real email or to belong to a real employee since it is not validated by PayFit. This field is deprecated, you should use the information on the collaborator entity instead.
    - `address` string, nullable — The address of the contract. This field is deprecated, you should use the information on the collaborator entity instead.
    - `city` string, nullable — The city address of the contract. This field is deprecated, you should use the information on the collaborator entity instead.
    - `postalCode` string, nullable — The postal code address of the contract. This field is deprecated, you should use the information on the collaborator entity instead.
  - `meta` object
    - `nextPageToken` string, nullable
    - `count` integer, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/payfit/apis/partner-api.md) · [All operations](https://skmtc.net/payfit/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payfit/partner-api/versions/fd1fb9262946/schema)