---
title: "Get a contract 🌍"
method: GET
path: "/companies/{companyId}/contracts/{contractId}"
tags: ["Contract"]
---

# Get a contract 🌍

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

## Request

- Base URL: `https://partner-api.payfit.com`
- URL: `https://partner-api.payfit.com/companies/{companyId}/contracts/{contractId}`
- 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/:contractId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a contract information by ID.
\
**Required scopes**: *contracts:read*

## Path parameters

- `companyId` string, required
- `contractId` string, required

## Response `200`

Detail of a contract by ID

- object: It will contain every information related to the time information
  - `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.

## Other responses

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

## Changes

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

[Operation history](https://skmtc.dev/payfit/apis/partner-api/changes/companies/:companyId/contracts/:contractId/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)