> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.client-p.pylote.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Recuperer les freelances supprimes

> Retourne les freelances dont le compte a ete supprime, banni, exclu ou rendu invisible.

**Important** : quand vous recevez un freelance avec `status: deleted` via `GET /freelances`,
vous devez le supprimer de votre base. Cette route permet de recuperer la liste
complete des profils a supprimer.




## OpenAPI

````yaml /openapi.yaml get /freelances/deleted-freelances
openapi: 3.1.0
info:
  title: Pylote Client API
  version: 1.0.4
  description: >
    API de distribution des profils freelances Pylote.


    Permet aux clients (recruteurs, integrateurs, partenaires) de recuperer

    les freelances depuis la base Pylote, gerer les whitelist recruteurs

    et tracker les consultations de profils.


    Les profils sont retournes au format [JSON
    Resume](https://jsonresume.org/schema/)

    enrichi avec les metadonnees Pylote (disponibilite, TJM, mobilites,
    competences).


    ## Engagements clients


    En utilisant cette API, vous vous engagez a :

    1. **Tracker les consultations** de profils via `POST
    /partners/{slug}/events` (contractuel)

    2. **Supprimer les profils** dont le `status` est `deleted` de votre base

    3. **Ne jamais exposer** les emails personnels des freelances (utiliser les
    emails proxy Pylote)


    ## Protection des donnees


    Les donnees sont transformees avant distribution :

    - Les emails personnels sont remplaces par des **emails proxy**
    (`@freelance.pylote.io`)

    - Le champ `personalEmail` est un **hash SHA-256** (pour dedoublonnage,
    jamais l'email en clair)

    - Les URLs LinkedIn et CV passent par `hive.pylote.io` (tracking watermarke)

    - Les identifiants (`meta.id`) sont **chiffres** (AES-256-CBC) et opaques
  contact:
    name: Pylote
    url: https://pylote.io
    email: contact@pylote.io
servers:
  - url: https://client-p.pylote.io
    description: Production
  - url: https://client-pp.pylote.io
    description: Preprod
security:
  - apiKey: []
tags:
  - name: Freelances
    description: >
      Endpoints principaux pour recuperer les profils freelances.

      Les profils sont au format JSON Resume enrichi avec les metadonnees
      Pylote.
  - name: Partners
    description: >
      Endpoints pour les partenaires de distribution (ex: Agrega).

      Gestion de la whitelist recruteurs et **tracking obligatoire** des
      consultations de profils.
  - name: Integration
    description: |
      Endpoints pour les integrateurs (ex: BoondManager).
      Gestion des sous-clients et de leurs whitelist recruteurs.
  - name: Sandbox
    description: >
      Endpoints de test avec donnees anonymisees. Aucune cle API requise.

      Utilisez la sandbox pour valider votre integration avant de passer en
      production.
  - name: Admin
    description: >-
      Endpoints d'administration (cache, debug). Requiert un flag admin sur la
      cle API.
  - name: Health
    description: Health check de l'API et de ses dependances externes
paths:
  /freelances/deleted-freelances:
    get:
      tags:
        - Freelances
      summary: Recuperer les freelances supprimes
      description: >
        Retourne les freelances dont le compte a ete supprime, banni, exclu ou
        rendu invisible.


        **Important** : quand vous recevez un freelance avec `status: deleted`
        via `GET /freelances`,

        vous devez le supprimer de votre base. Cette route permet de recuperer
        la liste

        complete des profils a supprimer.
      operationId: getDeletedFreelances
      parameters:
        - name: modifiedTime
          in: query
          required: true
          schema:
            type: integer
          example: 1712089295
        - name: page
          in: query
          required: true
          schema:
            type: integer
            minimum: 1
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            maximum: 1000
        - name: showDeleted
          in: query
          required: true
          description: Doit etre `true`
          schema:
            type: boolean
            enum:
              - true
      responses:
        '200':
          description: Liste paginee de freelances supprimes
          content:
            application/json:
              schema:
                type: object
                properties:
                  freelances:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeletedFreelance'
                  infos:
                    $ref: '#/components/schemas/PaginationInfos'
components:
  schemas:
    DeletedFreelance:
      type: object
      properties:
        basics:
          type: object
          properties:
            email:
              type: string
        meta:
          type: object
          properties:
            status:
              type: string
              enum:
                - account_deleted
                - account_banned
                - account_excluded
                - account_invisible
            deletedAt:
              type: integer
              description: Timestamp Unix de la suppression
    PaginationInfos:
      type: object
      properties:
        total:
          type: integer
          description: Nombre total de freelances correspondant aux criteres
          example: 1234
        page:
          type: integer
          description: Page actuelle
          example: 1
        limit:
          type: integer
          description: Nombre de freelances par page
          example: 50
        totalPages:
          type: integer
          description: Nombre total de pages
          example: 25
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >
        Cle API fournie par Pylote. Inclure dans le header `x-api-key` de chaque
        requete.


        Exemple : `x-api-key: votre-cle-api`

````