L’URSSAF publie ses API sur un portail dédié, le catalogue du Portail API Urssaf. On y compte 9 fiches. Une seule est présentée comme publique, et même celle-là demande une souscription. Pour les autres, il faut un compte, une demande d’habilitation et, souvent, la patience d’attendre la validation.
Une API (interface de programmation d’application) permet à un logiciel de dialoguer directement avec les systèmes de l’URSSAF, sans passer par un formulaire en ligne. Concrètement : votre logiciel de paie, votre outil de facturation ou votre plateforme envoie et reçoit des données en automatique. Les premiers concernés sont les éditeurs, les sociétés de services à la personne, les plateformes numériques et les cabinets comptables qui déclarent pour le compte de leurs clients.
Pour la donnée statistique (effectifs, masse salariale, données par secteur), c’est un autre site : le portail open data open.urssaf.fr.
Comment accéder aux API de l’URSSAF
Le parcours est le même pour toutes les API à accès restreint :
- créer un compte sur le Portail API Urssaf ;
- ouvrir la fiche de l’API voulue et cliquer sur « Souscrire à cette API » ;
- lire les CGU de l’API, propres à chaque service ;
- récupérer la documentation et la sandbox quand elle existe (DPAE, Mobilité internationale, Tiers de prestations, ODSPN).
Les API sont gratuites. La plupart utilisent une authentification OAuth2 de type Client Credentials : votre logiciel s’identifie avec ses propres identifiants, pas avec ceux d’un utilisateur. Chaque fiche affiche les versions en production et en sandbox ainsi que l’état du service.
Petite incohérence au passage : dans le catalogue, l’API de vérification des attestations est étiquetée « Accès public », mais sa fiche précise qu’il s’agit d’une API à accès restreint, sur souscription. Du pur URSSAF.
Les API pour les employeurs et la paie
API DPAE
Fiche officielle de l’API DPAE (accès restreint).
Elle permet au logiciel qui produit les déclarations préalables à l’embauche de s’authentifier directement sur le point de dépôt URSSAF et d’envoyer de très gros volumes de DPAE. En retour, le logiciel reçoit les accusés d’enregistrement électronique, les certificats de conformité et le compte rendu métier, c’est-à-dire l’accusé de réception de la DPAE. Elle s’adresse aux déclarants directs, aux tiers déclarants et aux intermédiaires techniques (offres SaaS).
Pour le détail de l’obligation elle-même, voir notre article sur la déclaration préalable à l’embauche, notre fiche API DPAE et le point sur la DPAE en DSN reportée à 2027.
API Attestations Vérification Code Sécurité
Fiche officielle de l’API Attestations Vérification Code Sécurité.
À partir du code de sécurité imprimé sur une attestation URSSAF, l’API vérifie que le document est authentique. C’est l’outil des donneurs d’ordre qui reçoivent des dizaines d’attestations de vigilance par semestre et ne veulent plus les vérifier une par une sur le site de l’URSSAF.
API Mobilité internationale
Fiche officielle de l’API Mobilité internationale (accès restreint, production et sandbox).
Elle permet de déposer directement les demandes de détachement au sein de l’Espace économique européen, sans remplir le formulaire de demande de mobilité internationale. Utile pour les entreprises et cabinets qui détachent régulièrement des salariés : les demandes partent depuis le logiciel RH plutôt qu’une par une. Le cadre général est détaillé dans notre article sur la sécurité sociale en situation de mobilité internationale.
Les API pour les particuliers employeurs et les services à la personne
API Tiers de prestations
Fiche officielle de l’API Tiers de prestations (accès restreint, production et sandbox).
C’est l’API de l’avance immédiate de crédit d’impôt (AICI) pour les prestataires et mandataires de services à la personne. Elle permet :
- d’inscrire un client au service pour qu’il bénéficie du crédit d’impôt sur ses prestations ;
- de transmettre les demandes de paiement de ses clients ;
- de récupérer les informations des demandes de paiement enregistrées.
Le client ne paie ainsi que sa part, sans avancer les 50 % de crédit d’impôt.
API Tierce Déclaration CESU
Fiche officielle de l’API Tierce Déclaration CESU (accès restreint).
Pour le compte d’un particulier employeur, le tiers déclarant peut l’inscrire à l’offre CESU, activer CESU+ pour lui et son salarié, activer l’avance immédiate de crédit d’impôt, obtenir le montant des cotisations, déclarer le salaire versé et appliquer le prélèvement à la source prévu à l’article 204 A du code général des impôts.
API Tierce Déclaration PAJE
Fiche officielle de l’API Tierce Déclaration PAJE (accès restreint).
Même logique pour Pajemploi : vérifier le compte d’un particulier employeur et les enfants ouvrant droit, enregistrer ou annuler un mandat de tierce déclaration, estimer les cotisations, puis pré-déclarer ou déclarer le salaire d’une assistante maternelle agréée ou d’une garde d’enfants à domicile, avec retenue à la source.
Les API pour les indépendants et les plateformes
API Tierce Déclaration auto-entrepreneur
Fiche officielle de l’API Tierce Déclaration auto-entrepreneur (accès restreint).
Pour le compte d’un auto-entrepreneur, elle donne accès à la déclaration du chiffre d’affaires, au calcul des cotisations et contributions sociales dues et à l’ordre de paiement. C’est la brique utilisée par les outils de gestion et les cabinets qui déclarent pour des micro-entrepreneurs.
ODSPN API Platforms (production et sandbox)
Fiche officielle ODSPN API Platforms et fiche de la sandbox (accès restreint).
Elle sert au prélèvement à la source des cotisations sociales des auto-entrepreneurs par les plateformes numériques. La plateforme automatise ses échanges avec l’URSSAF, à condition de s’être d’abord inscrite sur le portail Plateforme numérique. La sandbox permet de tester les échanges avant la mise en production.
Tableau récapitulatif des 9 API
| API | Pour qui | Accès | Lien |
|---|---|---|---|
| DPAE | Employeurs, éditeurs de paie, tiers déclarants | Restreint | Fiche |
| Attestations Vérification Code Sécurité | Donneurs d’ordre | Affiché public, souscription requise | Fiche |
| Mobilité internationale | Employeurs qui détachent dans l’EEE | Restreint | Fiche |
| Tiers de prestations | Services à la personne (avance immédiate) | Restreint | Fiche |
| Tierce Déclaration CESU | Tiers déclarants de particuliers employeurs | Restreint | Fiche |
| Tierce Déclaration PAJE | Tiers déclarants Pajemploi | Restreint | Fiche |
| Tierce Déclaration auto-entrepreneur | Outils et cabinets pour micro-entrepreneurs | Restreint | Fiche |
| ODSPN API Platforms | Plateformes numériques | Restreint | Fiche |
| ODSPN API Platforms Sandbox | Plateformes numériques (tests) | Restreint | Fiche |
Liste établie à partir du catalogue officiel en octobre 2026. L’URSSAF a déjà changé l’adresse de toutes ses fiches une fois (les anciens liens à identifiant mènent aujourd’hui à une page introuvable) : en cas de doute, repartez du catalogue.
Et la DSN dans tout ça ?
Elle n’est pas dans ce catalogue. La DSN se dépose via Net-entreprises ou par un point de dépôt machine à machine dont les spécifications relèvent du GIP-MDS. Une API qui envoie vite ne protège pas d’une donnée fausse : une DPAE transmise en 2 secondes avec un mauvais SIRET reste une DPAE fausse, et une DSN mal paramétrée reste fausse quel que soit son canal de dépôt.
Questions fréquentes
Où trouver la liste des API de l’URSSAF ?
Sur le catalogue du Portail API Urssaf (portailapi.urssaf.fr/fr/catalogue-api), qui recense 9 fiches avec leur documentation, leurs CGU et le bouton de souscription.
Les API de l’URSSAF sont-elles gratuites ?
Oui. Elles sont gratuites, mais presque toutes à accès restreint : il faut créer un compte sur le portail et souscrire à chaque API.
Existe-t-il une API URSSAF pour vérifier une attestation de vigilance ?
Oui, l’API Attestations Vérification Code Sécurité. Elle contrôle l’authenticité d’une attestation à partir de son code de sécurité.
Peut-on déclarer une DPAE par API ?
Oui, avec l’API DPAE, destinée aux logiciels qui produisent les déclarations préalables à l’embauche et aux tiers déclarants. Elle renvoie l’accusé d’enregistrement et l’accusé de réception de la DPAE.
Vos déclarations sont-elles justes avant d’être rapides ?
Automatiser l’envoi ne corrige rien. Le Lecteur DSN Cobham contrôle vos DSN et vos paies avant dépôt et repère les anomalies que l’URSSAF vous renverra sinon des mois plus tard.