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

# List all Contracts 🇫🇷

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

## Request

- Base URL: `https://partner-api.payfit.com`
- URL: `https://partner-api.payfit.com/companies/{companyId}/contracts-fr`
- Auth: OAuth 2
  - Authorization code: `https://oauth.payfit.com/authorize`
  - Token URL: `https://oauth.payfit.com/token` scopes: `contracts:read`
- TypeScript: <https://skmtc.dev/payfit/apis/partner-api/docs/companies/:companyId/contracts-fr/get.ts> (a function with typed inputs; its response is checked against the schema)

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, nullable, 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

## Changes

- **2026-11-03** `4ad2186afd5e`: 2 breaking
  - the response property `contracts/items/allOf[subschema #1: contract]/allOf[subschema #1: contract]/allOf[subschema #2]/startDate` became nullable for the status `200`
  - the response property `contracts/items/allOf[subschema #2: contract-fr]/allOf[subschema #1: contract]/allOf[subschema #2]/startDate` became nullable for the status `200`

[Operation history](https://skmtc.dev/payfit/apis/partner-api/changes/companies/:companyId/contracts-fr/get.md)

---

[API](https://skmtc.dev/payfit/apis/partner-api.md) - [All operations](https://skmtc.dev/payfit/apis/partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payfit/apis/partner-api/revisions/4ad2186afd5e?raw)