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

# List all Contracts 🇫🇷

`GET /companies/{companyId}/contracts-fr`

Returns all Contracts with french specific data. This list is paginated.
\
**Required scopes**: *contracts:read*

## Path parameters

- `companyId` string, required

## Query parameters

- `nextPageToken` string
- `maxResults` string
- `fields` 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.
    - `natureContratDsn` '01' | '02' | '03' | '07' | '08' | '09' | '10' | '20' | '21' | '29' | '32' | '50' | '51' | '52' | '53' | '60' | '70' | '80' | '81' | '82' | '89' | '90' | '91' | '92' | '93' | 'null', nullable, required — The nature of the contract. Correspond to the variable DSN "S21.G00.40.007" as described in the ["Cahier technique DSN"](https://www.net-entreprises.fr/media/documentation/dsn-cahier-technique-2022.1.pdf#ChangementsContrat.StatutConventionnel). Can be null if the contract is in PENDING status.
    - `motifRuptureDeContratDsn` '011' | '012' | '014' | '015' | '020' | '025' | '026' | '031' | '032' | '033' | '034' | '035' | '036' | '037' | '038' | '039' | '040' | '043' | '058' | '059' | '065' | '066' | '070' | '071' | '081' | '082' | '083' | '084' | '085' | '086' | '087' | '088' | '089' | '091' | '092' | '093' | '094' | '095' | '096' | '097' | '098' | '099' | '100' | '110' | '111' | '112' | '113' | '114' | '115' | '116' | '998' | '999' | 'null', nullable, required — The reason of contract termination. Correspond to the variable DSN "S21.G00.62.002" as described in the ["Cahier technique DSN"](https://www.net-entreprises.fr/media/documentation/dsn-cahier-technique-2022.1.pdf#ChangementsContrat.StatutConventionnel).
    - `statutConventionnelDsn` '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | 'null', nullable, required — The status of the contract. Correspond to the variable DSN "S21.G00.40.002" as described in the ["Cahier technique DSN"](https://www.net-entreprises.fr/media/documentation/dsn-cahier-technique-2022.1.pdf#ChangementsContrat.StatutConventionnel). Can be null if the contract is in PENDING status.
    - `idcc` string, nullable, required — The "identifiant de convention collective" of the contract. Correspond to the variable DSN "S21.G00.40.017" as described in the ["Cahier technique DSN"](https://www.net-entreprises.fr/media/documentation/dsn-cahier-technique-2022.1.pdf). If the status of the contract is ARCHIVED, this value might be null.
    - `healthInsuranceContractIds` string[], nullable, required — List of the health insurance contracts the contract is affiliated to. It will be available if `health-insurance:read` scope is set on the token.
    - `providentFundContractIds` string[], nullable, required — List of the provident funds contracts the contract is affiliated to. It will be available if `health-insurance:read` scope is set on the token.
    - `estCadreDirigeant` boolean, required — Indicates whether the contract is a contract "cadre dirigeant" or not.
    - `workingTimeModality` 'standard' | 'forfait_heures' | 'forfait_jours' | 'forfait_annuel_en_heures' | 'forfait_sans_reference_horaire' | 'null', nullable, required — Contractual working time modality. It will be available if `contracts:time-information:read` scope is set on the token.
    - `numeroTechniqueTemporaire` string, nullable, required — "Numéro technique temporaire" of the contract
    - `numeroSecuriteSociale` string, nullable, required — "Numéro de sécurité sociale" of the contract
  - `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)
