---
title: "List all Worked Time by contract 🇫🇷"
method: GET
path: "/companies/{companyId}/contracts/time"
tags: ["Contract"]
---

# List all Worked Time by contract 🇫🇷

`GET /companies/{companyId}/contracts/time`

## Request

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

Returns the worked time for every contract for the given pay period. This list is paginated.
\
**Required scopes**: *time:read*

## Path parameters

- `companyId` string, required

## Query parameters

- `nextPageToken` string
- `maxResults` string
- `date` string, required

## Response `200`

Returns the worked time for every contract for the given pay period. Note : this endpoint is only available for French companies for now.

- object
  - `contracts` object[], required
    - `effectiveWorkedTime` number, nullable, required: It will be available if `time:read` scope is set on the token.
    - `payedWorkedTime` number, nullable, required: It will be available if `time:read` scope is set on the token.
    - `workTimeUnit` 'days' | 'hours', nullable, required: It will be available if `time:read` scope is set on the token.
    - `contractId` string, required
  - `meta` object, required
    - `nextPageToken` string, nullable
    - `count` integer, nullable

## Other responses

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

---

[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)