applications

Rechercher et filtrer les applications

Changed on Oct 7, 2026

Endpoint unifié pour rechercher, filtrer et paginer les applications. Supporte tous les types de filtres : label, shortName, tags, priorityRestart, hostingSearch, etc. Inclut la pagination et le tri.

get/api/v2/applications

Request

The document declares no server URL.
Auth: one of:
- OAuth 2 (authorization code, authorization URL http://localhost:8082/realms/referentiel-applications/protocol/openid-connect/auth, token URL http://localhost:8082/realms/referentiel-applications/protocol/openid-connect/token)
- API key in header x-refapp-token

Query parameters

pagenumber

Numéro de page

pageSizenumber

Example:15

Nombre de résultats par page, 0 pour supprimer la pagination

sortBystring

Example:label

Champ utilisé pour le tri

order'asc' | 'desc'

Example:asc

Ordre de tri

searchstring

Example:Mon Application

Recherche sur les labels et shortName

qstring

Example:gestion des factures

Recherche full-text sur l'ensemble des informations descriptives de la fiche (libellé, nom court, description, finalités, populations cibles, tags, labels, acteurs). Insensible à la casse et aux accents, avec lemmatisation française et tri par pertinence. Tous les mots saisis doivent être présents (ET) ; la ponctuation est ignorée.

qPrefixstring

Example:tow muel

Recherche full-text en mode préfixe, pour l'autocomplétion au fil de la frappe (chaque mot saisi est traité comme un préfixe). Même périmètre que q. Prioritaire sur q s'il est fourni. Limité aux 200 résultats les plus pertinents.

labelstring

Example:Mon Application

Recherche par label

shortNamestring

Recherche par shortName

tagstring[]

Filtrer par tags (un ou plusieurs)

priorityRestartstring[]

Filtrer par une ou plusieurs priorités de redémarrage (R0 à R3)

[
  "R1",
  "R2"
]

actorTypestring

Example:MOA

Type d'acteur. Utiliser les valeurs de /actorTypes

actorEmailstring

Example:user@example.com

Email d'un acteur pour filtrer les applications

missingMoaboolean

Example:true

Filtrer les applications sans MOA

missingMoeboolean

Example:true

Filtrer les applications sans MOE

missingHostingboolean

Example:true

Filtrer les applications sans hébergement

currentStatus__instring[]

Filtrer par un ou plusieurs status du statut courant

currentStatus__isNullboolean

Example:true

Filtrer les applications sans statut

subscribersEmailboolean

Example:true

Filtrer les applications abonné

myApplicationsboolean

Example:true

Filtrer les applications par acteur et groupe acteurs

organizationstring

Example:Direction des systèmes d'information

Nom de l'organisation liée à l'application

hostingSearchstring

Example:Paris

Recherche unifiée sur tous les champs d'hébergement (site, plateforme, fournisseur, bâtiment, salle)

hostingSitestring

Example:Paris

Filtrer par site d'hébergement

hostingPlatformstring

Example:AWS

Filtrer par plateforme d'hébergement

hostingProviderstring

Example:Amazon

Filtrer par fournisseur d'hébergement

hostingBuildingstring

Example:Bâtiment A

Filtrer par bâtiment d'hébergement

hostingRoomstring

Example:Salle 101

Filtrer par pièce d'hébergement

compliance__instring[]

[Déprécié] Filtrer par conformité présente. Utiliser plutôt compliancePresent__in.

compliancePresent__instring[]

Critères de conformité devant être présents (renseignés) sur l'application

complianceAbsent__instring[]

Critères de conformité absents : pour un critère booléen (pra, dsfr) = explicitement Non (false) ; pour les autres = non renseigné

complianceUnset__instring[]

Critères de conformité non renseignés (valeur nulle). Pertinent pour les critères booléens (pra, dsfr)

linkstring

Recherche par lien (ressource externe)

iqGtenumber

Recherche par indice de qualité minimum

iqLtenumber

Recherche par indice de qualité maximum

iq__isNullboolean

Example:true

Inclure les applications sans IQ (décommissionnées ou supprimées) en plus de celles dans la plage iqGte/iqLte

columnsstring

Example:id,label,shortName,description

Colonnes à inclure dans l'export

isActorstring

Ne retourne que les applications dont l'utilisateur est acteur, defaut: false

is_part_of'NEUTRAL' | 'INCLUDE' | 'EXCLUDE'

Filtrée sur la relation de type Fait partie de

in_replacement_of'NEUTRAL' | 'INCLUDE' | 'EXCLUDE'

Filtrée sur la relation de type Remplace

is_service_user_of'NEUTRAL' | 'INCLUDE' | 'EXCLUDE'

Filtrée sur la relation de type Utilise le service de

is_data_user_of'NEUTRAL' | 'INCLUDE' | 'EXCLUDE'

Filtrée sur la relation de type Utilise la donnée de

use_sso_of'NEUTRAL' | 'INCLUDE' | 'EXCLUDE'

Filtrée sur la relation de type Utilise le SSO de

is_correlated_with'NEUTRAL' | 'INCLUDE' | 'EXCLUDE'

Filtrée sur la relation de type Est corrélée à (symétrique : les deux directions sont considérées)

relationAppIdstring

Filtrage des relations sur cette app

businessDivisionIdstring[]

Filtrage des directions de metier MOA (une ou plusieurs)

is_mediation_service'NEUTRAL' | 'INCLUDE' | 'EXCLUDE'

Filtrée sur la mediation de service

dataSourceNamestring

Recherche par nom de source de données

millesimenumber

Example:2026

Millésime (année) de la campagne dette IT à présenter. Par défaut, le millésime le plus récent disponible.

Response

Liste des applications correspondant aux critères de recherche avec pagination.

totalnumber required

Total number of items

averageIqnumber required

IQ moyen calculé sur l'ensemble des applications correspondant aux critères (toutes pages confondues)

Example response

{
  "results": [
    {
      "logo": "https://example.com/logo.png",
      "technicalDebtInfo": {
        "technicalMaturity": 3.2,
        "businessMaturity": 4.5,
        "costContainment": 2.75,
        "millesime": 2026,
        "id": "uuid-example",
        "applicationId": "uuid-example"
      },
      "businessDivisions": [
        {
          "label": "farm"
        }
      ],
      "hostings": [
        {
          "hostingOption": {
            "site": "CER(RENNES)",
            "platform": "PHYSIQUE",
            "provider": "DTNUM",
            "building": "B15",
            "room": "IT2",
            "id": "12345678-1234-1234-1234-123456789012"
          }
        }
      ],
      "tags": [
        {
          "name": "securite",
          "createdAt": "2025-01-01T00:00:00.000Z"
        }
      ],
      "actors": [
        {
          "actorType": {
            "code": "MOA",
            "label": "Maîtrise d’Ouvrage",
            "description": "La MOA définit les besoins du projet, supervise sa mise en œuvre et veille à ce que les objectifs métiers soient atteints.",
            "id": "12345678-1234-1234-1234-123456789012"
          }
        }
      ],
      "compliance": {
        "dima_duration_hours": 4,
        "dima_is_hno": true,
        "dima_business_impact": "Perte de revenu, impact client",
        "dima_recovery_plan": true,
        "dima_recovery_solutions": "Bascule sur serveur de secours",
        "dima_last_test_date": "2023-01-01",
        "dima_recovery_manager": "Jean Dupont",
        "pdma_duration_hours": 24,
        "pdma_data_types": "Transactions, logs, fichiers utilisateur",
        "pdma_backup_frequency": "Toutes les heures",
        "pdma_backup_method": "Snapshot, backup incrémental",
        "pdma_last_test_date": "2023-01-01",
        "pdma_restoration_manager": "Marie Martin",
        "homologation_date_end": "2023-01-01",
        "homologation_rssi_id": "uuid-of-rssi-actor",
        "dsfr_implemented": true,
        "dsfr_version": "1.9.0",
        "rgpd_has_aipd": true,
        "rgpd_dpo_name": "Pierre Durand",
        "eco_index_target_url": "https://service.example.com",
        "id": "12345678-1234-1234-1234-123456789012",
        "eco_index_score": 72.5,
        "eco_index_ges": 1.77,
        "eco_index_water": 2.65,
        "eco_index_last_calculated_at": "2026-03-20T10:30:00.000Z"
      },
      "rgaaScorePercentage": 75.5
    }
  ],
  "total": 100,
  "averageIq": 72.5,
  "technicalDebtPoints": [
    {
      "logo": "https://example.com/logo.png",
      "technicalDebtInfo": {
        "technicalMaturity": 3.2,
        "businessMaturity": 4.5,
        "costContainment": 2.75,
        "millesime": 2026,
        "id": "uuid-example",
        "applicationId": "uuid-example"
      },
      "businessDivisions": [
        {
          "label": "farm"
        }
      ],
      "hostings": [
        {
          "hostingOption": {
            "site": "CER(RENNES)",
            "platform": "PHYSIQUE",
            "provider": "DTNUM",
            "building": "B15",
            "room": "IT2",
            "id": "12345678-1234-1234-1234-123456789012"
          }
        }
      ],
      "tags": [
        {
          "name": "securite",
          "createdAt": "2025-01-01T00:00:00.000Z"
        }
      ],
      "actors": [
        {
          "actorType": {
            "code": "MOA",
            "label": "Maîtrise d’Ouvrage",
            "description": "La MOA définit les besoins du projet, supervise sa mise en œuvre et veille à ce que les objectifs métiers soient atteints.",
            "id": "12345678-1234-1234-1234-123456789012"
          }
        }
      ],
      "compliance": {
        "dima_duration_hours": 4,
        "dima_is_hno": true,
        "dima_business_impact": "Perte de revenu, impact client",
        "dima_recovery_plan": true,
        "dima_recovery_solutions": "Bascule sur serveur de secours",
        "dima_last_test_date": "2023-01-01",
        "dima_recovery_manager": "Jean Dupont",
        "pdma_duration_hours": 24,
        "pdma_data_types": "Transactions, logs, fichiers utilisateur",
        "pdma_backup_frequency": "Toutes les heures",
        "pdma_backup_method": "Snapshot, backup incrémental",
        "pdma_last_test_date": "2023-01-01",
        "pdma_restoration_manager": "Marie Martin",
        "homologation_date_end": "2023-01-01",
        "homologation_rssi_id": "uuid-of-rssi-actor",
        "dsfr_implemented": true,
        "dsfr_version": "1.9.0",
        "rgpd_has_aipd": true,
        "rgpd_dpo_name": "Pierre Durand",
        "eco_index_target_url": "https://service.example.com",
        "id": "12345678-1234-1234-1234-123456789012",
        "eco_index_score": 72.5,
        "eco_index_ges": 1.77,
        "eco_index_water": 2.65,
        "eco_index_last_calculated_at": "2026-03-20T10:30:00.000Z"
      },
      "rgaaScorePercentage": 75.5
    }
  ]
}

Changes

Oct 7, 20261fffb2d3f8b9 Revision changes
- info
  added the new optional query request parameter is_correlated_with
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
Aug 14, 2026229a5a2c1ae1 Revision changes
- info
  added the new optional query request parameter iq__isNull

Operation history