---
title: "Lister les collaborateurs"
description: "Liste paginée des collaborateurs de l’entreprise, triés par nom puis prénom. Avec un filtre sur un collaborateur, une liste vide renvoie `404`."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.puncto.fr/llms.txt
> Use this file to discover all available pages before exploring further.

Path: API Puncto › Collaborateurs

`GET /public/v1/collaborators`

Liste paginée des collaborateurs de l’entreprise, triés par nom puis prénom. Avec un filtre sur un collaborateur, une liste vide renvoie `404`.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listCollaborators.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listCollaborators.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `collaboratorId` (`listCollaborators.query.collaboratorId`; string, optional) — Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.
  - example `"coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorForeignErpId` (`listCollaborators.query.collaboratorForeignErpId`; string, optional) — Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.
  - example `"salarie-123"`

## Code samples

### cURL

```bash
curl --request GET \
  --url https://api.puncto.fr/public/v1/collaborators \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/collaborators';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.puncto.fr/public/v1/collaborators"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

Page de collaborateurs

#### Example

```json
{
  "data": [
    {
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "companyId": "comp_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "establishmentId": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "firstName": "string",
      "lastName": "string",
      "usageFirstName": "string",
      "usageLastName": "string",
      "email": "string",
      "phoneNumber": "string",
      "birthDate": "2019-08-24",
      "birthCity": "string",
      "birthDepartmentCode": "string",
      "birthCountryCode": "FR",
      "nationality": "FR",
      "originUeCodification": "01",
      "identity": {
        "type": "NTT",
        "numero": "string",
        "startDate": "2019-08-24"
      },
      "socialSecurityNumber": "string",
      "ntt": "string",
      "sex": "FEMALE",
      "address": {
        "id": "addr_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "address": "string",
        "postalCode": "string",
        "city": "string",
        "addressDetails": "string",
        "countryCode": "FR"
      },
      "dependentChildrenCount": 0,
      "disabledDependentChildrenCount": 0,
      "maritalStatus": "SINGLE",
      "isBoeth": true,
      "boethStatus": "INVALIDITY_PENSION",
      "seniorityDate": "2019-08-24",
      "paymentOption": {
        "type": "virement",
        "iban": "string",
        "bic": "string"
      },
      "matriculeRh": "string",
      "conventionalPosition": {
        "type": "CADRE",
        "position": "1.1"
      },
      "coefficient": 0,
      "foreignErpId": "string",
      "managerId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "perPage": 0,
    "currentPage": 0,
    "firstPage": 0,
    "lastPage": 0
  }
}
```

- `data` (`listCollaborators.response.200.data`; array<object>, required)
  - `collaboratorId` (`listCollaborators.response.200.data.collaboratorId`; string, required) — Identifiant Puncto
  - `companyId` (`listCollaborators.response.200.data.companyId`; string, required) — Identifiant Puncto
  - `establishmentId` (`listCollaborators.response.200.data.establishmentId`; any of, required) — Établissement du contrat courant — null pour un collaborateur sans contrat
    - any of: `string`, `null`
  - `firstName` (`listCollaborators.response.200.data.firstName`; string, required)
  - `lastName` (`listCollaborators.response.200.data.lastName`; string, required)
  - `usageFirstName` (`listCollaborators.response.200.data.usageFirstName`; string | null, required)
  - `usageLastName` (`listCollaborators.response.200.data.usageLastName`; string | null, required)
  - `email` (`listCollaborators.response.200.data.email`; string | null, required)
  - `phoneNumber` (`listCollaborators.response.200.data.phoneNumber`; string | null, required)
  - `birthDate` (`listCollaborators.response.200.data.birthDate`; string, required)
    - format `date`
  - `birthCity` (`listCollaborators.response.200.data.birthCity`; string, required)
  - `birthDepartmentCode` (`listCollaborators.response.200.data.birthDepartmentCode`; string, required) — Pour les salariés nés dans les TOM : code 98 Pour les personnes nées à l'étranger : code 99
  - `birthCountryCode` (`listCollaborators.response.200.data.birthCountryCode`; string, required)
    - one of `"FR"`, `"GP"`, `"BL"`, `"MF"`, `"MQ"`, `"GF"`, `"RE"`, `"PM"`, `"YT"`, `"WF"`, `"PF"`, `"NC"`, `"MC"`, `"AF"`, `"AL"`, `"DZ"`, `"AD"`, `"AO"`, `"AG"`, `"AR"`, `"AM"`, `"AU"`, `"AT"`, `"AZ"`, `"BS"`, `"BH"`, `"BD"`, `"BB"`, `"BY"`, `"BE"`, `"BZ"`, `"BJ"`, `"BT"`, `"BO"`, `"BA"`, `"BW"`, `"BR"`, `"BN"`, `"BG"`, `"BF"`, `"BI"`, `"CV"`, `"KH"`, `"CM"`, `"CA"`, `"CF"`, `"TD"`, `"CL"`, `"CN"`, `"CO"`, `"KM"`, `"CD"`, `"CG"`, `"CR"`, `"CI"`, `"HR"`, `"CU"`, `"CY"`, `"CZ"`, `"DK"`, `"DJ"`, `"DM"`, `"DO"`, `"EC"`, `"EG"`, `"SV"`, `"GQ"`, `"ER"`, `"EE"`, `"SZ"`, `"ET"`, `"FJ"`, `"FI"`, `"GA"`, `"GM"`, `"GE"`, `"DE"`, `"GH"`, `"GR"`, `"GD"`, `"GT"`, `"GN"`, `"GW"`, `"GY"`, `"HT"`, `"HN"`, `"HU"`, `"IS"`, `"IN"`, `"ID"`, `"IR"`, `"IQ"`, `"IE"`, `"IL"`, `"IT"`, `"JM"`, `"JP"`, `"JO"`, `"KZ"`, `"KE"`, `"KI"`, `"KP"`, `"KR"`, `"KW"`, `"KG"`, `"LA"`, `"LV"`, `"LB"`, `"LS"`, `"LR"`, `"LY"`, `"LI"`, `"LT"`, `"LU"`, `"MG"`, `"MW"`, `"MY"`, `"MV"`, `"ML"`, `"MT"`, `"MH"`, `"MR"`, `"MU"`, `"MX"`, `"FM"`, `"MD"`, `"MN"`, `"ME"`, `"MA"`, `"MZ"`, `"MM"`, `"NA"`, `"NR"`, `"NP"`, `"NL"`, `"NZ"`, `"NI"`, `"NE"`, `"NG"`, `"NO"`, `"OM"`, `"PK"`, `"PW"`, `"PS"`, `"PA"`, `"PG"`, `"PY"`, `"PE"`, `"PH"`, `"PL"`, `"PT"`, `"QA"`, `"RO"`, `"RU"`, `"RW"`, `"KN"`, `"LC"`, `"VC"`, `"WS"`, `"SM"`, `"ST"`, `"SA"`, `"SN"`, `"RS"`, `"SC"`, `"SL"`, `"SG"`, `"SK"`, `"SI"`, `"SB"`, `"SO"`, `"ZA"`, `"SS"`, `"ES"`, `"LK"`, `"SD"`, `"SR"`, `"SE"`, `"CH"`, `"SY"`, `"TW"`, `"TJ"`, `"TZ"`, `"TH"`, `"TL"`, `"TG"`, `"TO"`, `"TT"`, `"TN"`, `"TR"`, `"TM"`, `"TV"`, `"UG"`, `"UA"`, `"AE"`, `"GB"`, `"US"`, `"UY"`, `"UZ"`, `"VU"`, `"VE"`, `"VN"`, `"YE"`, `"ZM"`, `"ZW"`
  - `nationality` (`listCollaborators.response.200.data.nationality`; string, required)
    - one of `"FR"`, `"GP"`, `"BL"`, `"MF"`, `"MQ"`, `"GF"`, `"RE"`, `"PM"`, `"YT"`, `"WF"`, `"PF"`, `"NC"`, `"MC"`, `"AF"`, `"AL"`, `"DZ"`, `"AD"`, `"AO"`, `"AG"`, `"AR"`, `"AM"`, `"AU"`, `"AT"`, `"AZ"`, `"BS"`, `"BH"`, `"BD"`, `"BB"`, `"BY"`, `"BE"`, `"BZ"`, `"BJ"`, `"BT"`, `"BO"`, `"BA"`, `"BW"`, `"BR"`, `"BN"`, `"BG"`, `"BF"`, `"BI"`, `"CV"`, `"KH"`, `"CM"`, `"CA"`, `"CF"`, `"TD"`, `"CL"`, `"CN"`, `"CO"`, `"KM"`, `"CD"`, `"CG"`, `"CR"`, `"CI"`, `"HR"`, `"CU"`, `"CY"`, `"CZ"`, `"DK"`, `"DJ"`, `"DM"`, `"DO"`, `"EC"`, `"EG"`, `"SV"`, `"GQ"`, `"ER"`, `"EE"`, `"SZ"`, `"ET"`, `"FJ"`, `"FI"`, `"GA"`, `"GM"`, `"GE"`, `"DE"`, `"GH"`, `"GR"`, `"GD"`, `"GT"`, `"GN"`, `"GW"`, `"GY"`, `"HT"`, `"HN"`, `"HU"`, `"IS"`, `"IN"`, `"ID"`, `"IR"`, `"IQ"`, `"IE"`, `"IL"`, `"IT"`, `"JM"`, `"JP"`, `"JO"`, `"KZ"`, `"KE"`, `"KI"`, `"KP"`, `"KR"`, `"KW"`, `"KG"`, `"LA"`, `"LV"`, `"LB"`, `"LS"`, `"LR"`, `"LY"`, `"LI"`, `"LT"`, `"LU"`, `"MG"`, `"MW"`, `"MY"`, `"MV"`, `"ML"`, `"MT"`, `"MH"`, `"MR"`, `"MU"`, `"MX"`, `"FM"`, `"MD"`, `"MN"`, `"ME"`, `"MA"`, `"MZ"`, `"MM"`, `"NA"`, `"NR"`, `"NP"`, `"NL"`, `"NZ"`, `"NI"`, `"NE"`, `"NG"`, `"NO"`, `"OM"`, `"PK"`, `"PW"`, `"PS"`, `"PA"`, `"PG"`, `"PY"`, `"PE"`, `"PH"`, `"PL"`, `"PT"`, `"QA"`, `"RO"`, `"RU"`, `"RW"`, `"KN"`, `"LC"`, `"VC"`, `"WS"`, `"SM"`, `"ST"`, `"SA"`, `"SN"`, `"RS"`, `"SC"`, `"SL"`, `"SG"`, `"SK"`, `"SI"`, `"SB"`, `"SO"`, `"ZA"`, `"SS"`, `"ES"`, `"LK"`, `"SD"`, `"SR"`, `"SE"`, `"CH"`, `"SY"`, `"TW"`, `"TJ"`, `"TZ"`, `"TH"`, `"TL"`, `"TG"`, `"TO"`, `"TT"`, `"TN"`, `"TR"`, `"TM"`, `"TV"`, `"UG"`, `"UA"`, `"AE"`, `"GB"`, `"US"`, `"UY"`, `"UZ"`, `"VU"`, `"VE"`, `"VN"`, `"YE"`, `"ZM"`, `"ZW"`
  - `originUeCodification` (`listCollaborators.response.200.data.originUeCodification`; string, required)
    - one of `"01"`, `"02"`, `"03"`, `"04"`
  - `identity` (`listCollaborators.response.200.data.identity`; any of, required) — Identité sociale en vigueur (NIR, NIA ou NTT). Pour un collaborateur dont l'embauche n'a pas encore commencé, sa première identité, qui prend effet le 1er du mois de son entrée.
    - any of: `ApiCollaboratorIdentity`, `null`
  - `socialSecurityNumber` (`listCollaborators.response.200.data.socialSecurityNumber`; string | null, required) — NIR ou NIA
  - `ntt` (`listCollaborators.response.200.data.ntt`; string | null, required) — NTT = NIR temporaire en l'absence de NIA
  - `sex` (`listCollaborators.response.200.data.sex`; string | null, required) — Sexe, déduit du premier chiffre du NIR, du NIA ou du NTT (impair : homme, pair : femme). Null quand il ne peut pas en être déduit.
    - one of `"FEMALE"`, `"MALE"`, `null`
  - `address` (`listCollaborators.response.200.data.address`; object, required)
    - `id` (`listCollaborators.response.200.data.address.id`; string, required) — Identifiant Puncto
    - `address` (`listCollaborators.response.200.data.address.address`; string, required)
    - `postalCode` (`listCollaborators.response.200.data.address.postalCode`; string, required)
    - `city` (`listCollaborators.response.200.data.address.city`; string, required)
    - `addressDetails` (`listCollaborators.response.200.data.address.addressDetails`; string | null, required)
    - `countryCode` (`listCollaborators.response.200.data.address.countryCode`; string, required)
      - one of `"FR"`, `"GP"`, `"BL"`, `"MF"`, `"MQ"`, `"GF"`, `"RE"`, `"PM"`, `"YT"`, `"WF"`, `"PF"`, `"NC"`, `"MC"`, `"AF"`, `"AL"`, `"DZ"`, `"AD"`, `"AO"`, `"AG"`, `"AR"`, `"AM"`, `"AU"`, `"AT"`, `"AZ"`, `"BS"`, `"BH"`, `"BD"`, `"BB"`, `"BY"`, `"BE"`, `"BZ"`, `"BJ"`, `"BT"`, `"BO"`, `"BA"`, `"BW"`, `"BR"`, `"BN"`, `"BG"`, `"BF"`, `"BI"`, `"CV"`, `"KH"`, `"CM"`, `"CA"`, `"CF"`, `"TD"`, `"CL"`, `"CN"`, `"CO"`, `"KM"`, `"CD"`, `"CG"`, `"CR"`, `"CI"`, `"HR"`, `"CU"`, `"CY"`, `"CZ"`, `"DK"`, `"DJ"`, `"DM"`, `"DO"`, `"EC"`, `"EG"`, `"SV"`, `"GQ"`, `"ER"`, `"EE"`, `"SZ"`, `"ET"`, `"FJ"`, `"FI"`, `"GA"`, `"GM"`, `"GE"`, `"DE"`, `"GH"`, `"GR"`, `"GD"`, `"GT"`, `"GN"`, `"GW"`, `"GY"`, `"HT"`, `"HN"`, `"HU"`, `"IS"`, `"IN"`, `"ID"`, `"IR"`, `"IQ"`, `"IE"`, `"IL"`, `"IT"`, `"JM"`, `"JP"`, `"JO"`, `"KZ"`, `"KE"`, `"KI"`, `"KP"`, `"KR"`, `"KW"`, `"KG"`, `"LA"`, `"LV"`, `"LB"`, `"LS"`, `"LR"`, `"LY"`, `"LI"`, `"LT"`, `"LU"`, `"MG"`, `"MW"`, `"MY"`, `"MV"`, `"ML"`, `"MT"`, `"MH"`, `"MR"`, `"MU"`, `"MX"`, `"FM"`, `"MD"`, `"MN"`, `"ME"`, `"MA"`, `"MZ"`, `"MM"`, `"NA"`, `"NR"`, `"NP"`, `"NL"`, `"NZ"`, `"NI"`, `"NE"`, `"NG"`, `"NO"`, `"OM"`, `"PK"`, `"PW"`, `"PS"`, `"PA"`, `"PG"`, `"PY"`, `"PE"`, `"PH"`, `"PL"`, `"PT"`, `"QA"`, `"RO"`, `"RU"`, `"RW"`, `"KN"`, `"LC"`, `"VC"`, `"WS"`, `"SM"`, `"ST"`, `"SA"`, `"SN"`, `"RS"`, `"SC"`, `"SL"`, `"SG"`, `"SK"`, `"SI"`, `"SB"`, `"SO"`, `"ZA"`, `"SS"`, `"ES"`, `"LK"`, `"SD"`, `"SR"`, `"SE"`, `"CH"`, `"SY"`, `"TW"`, `"TJ"`, `"TZ"`, `"TH"`, `"TL"`, `"TG"`, `"TO"`, `"TT"`, `"TN"`, `"TR"`, `"TM"`, `"TV"`, `"UG"`, `"UA"`, `"AE"`, `"GB"`, `"US"`, `"UY"`, `"UZ"`, `"VU"`, `"VE"`, `"VN"`, `"YE"`, `"ZM"`, `"ZW"`
  - `dependentChildrenCount` (`listCollaborators.response.200.data.dependentChildrenCount`; number, required) — Situation familiale
  - `disabledDependentChildrenCount` (`listCollaborators.response.200.data.disabledDependentChildrenCount`; number, required) — Parmi `dependentChildrenCount`, les enfants à charge handicapés
  - `maritalStatus` (`listCollaborators.response.200.data.maritalStatus`; any of, required) — Null tant qu'elle n'est pas renseignée
    - any of: `MaritalStatus`, `null`
  - `isBoeth` (`listCollaborators.response.200.data.isBoeth`; boolean, required)
  - `boethStatus` (`listCollaborators.response.200.data.boethStatus`; any of, required)
    - any of: `OnboardingHandicapValue`, `null`
  - `seniorityDate` (`listCollaborators.response.200.data.seniorityDate`; any of, required)
    - any of: `string`, `null`
  - `paymentOption` (`listCollaborators.response.200.data.paymentOption`; any of, required)
    - any of: `VirementPaymentOption`, `CheckPaymentOption`, `CashPaymentOption`
  - `matriculeRh` (`listCollaborators.response.200.data.matriculeRh`; string, required)
  - `conventionalPosition` (`listCollaborators.response.200.data.conventionalPosition`; any of, required) — Position Syntec de l'avenant en vigueur du contrat courant (pour un contrat qui n'a pas encore commencé : de son premier avenant) — null sans contrat ni position
    - any of: `SyntecPosition`, `null`
  - `coefficient` (`listCollaborators.response.200.data.coefficient`; number | null, required)
  - `foreignErpId` (`listCollaborators.response.200.data.foreignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, unique dans l'entreprise
  - `managerId` (`listCollaborators.response.200.data.managerId`; any of, required) — Manager du collaborateur, null s'il n'en a pas
    - any of: `string`, `null`
  - `createdAt` (`listCollaborators.response.200.data.createdAt`; string, required)
    - format `date-time`
  - `updatedAt` (`listCollaborators.response.200.data.updatedAt`; string, required)
    - format `date-time`
- `meta` (`listCollaborators.response.200.meta`; object, required)
  - `total` (`listCollaborators.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listCollaborators.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listCollaborators.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listCollaborators.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listCollaborators.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listCollaborators.response.200.meta.lastPage`; integer, required)

### 401

Clé d’API absente, invalide ou révoquée

#### Example

```json
{
  "error": "Les endpoints de l’API publique sont réservés aux comptes application."
}
```

- `error` (`listCollaborators.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listCollaborators.response.401.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 403

Opération hors de l’accès de la clé d’API

#### Example

```json
{
  "error": "Opération interdite"
}
```

- `error` (`listCollaborators.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listCollaborators.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Aucun collaborateur ne correspond au filtre

#### Example

```json
{
  "error": "Collaborateur non trouvé"
}
```

- `error` (`listCollaborators.response.404.error`; string, required) — Message lisible, en français.
- `errorCode` (`listCollaborators.response.404.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 422

Paramètres invalides

#### Example

```json
{
  "errors": [
    {
      "message": "Le champ statut de l’absence doit être une valeur autorisée",
      "rule": "enum",
      "field": "status"
    }
  ]
}
```

- `errors` (`listCollaborators.response.422.errors`; array<object>, required)
  - `message` (`listCollaborators.response.422.errors.message`; string, required)
  - `rule` (`listCollaborators.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`listCollaborators.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/collaborators/list/index.md
