Get your Urssaf employer account through an API

What you can build on the Urssaf espace en ligne

• Get an attestation de vigilance

  Build this

  In Documents, chooses Demander une attestation, selects attestation de vigilance (compliance certificate), validates and reads the file under Voir le fichier.

  Takes

  Nothing

  Returns

  Company name, Siret, issue date, 15-character security code, available now or emailed later

• Read the cotisations to pay

  Build this

  Reads Compte, then Paiement, then Payer les cotisations (pay contributions): the échéance (instalment) en cours after your DSN is validated.

  Takes

  Nothing

  Returns

  Period, amount due, due date, status

• Read your délais de paiement accordés

  Build this

  Reads Compte, then Paiement, then Délais de paiement accordés (granted payment plans), with the detail of each délai's échéances.

  Takes

  Nothing

  Returns

  Délai, total amount, échéances with due date, amount and status

• Request a délai de paiement

  Build this

  From the Tableau de bord, opens Régulariser, then Demander un délai, and fills in the amount, number of échéances, first échéance date and reasons.

  Takes

  Amount, number of échéances, first échéance date, reasons

  Returns

  Request outcome, échéancier proposed, next step shown

Automate the Urssaf espace en ligne with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• New échéances to pay, handed to accounting

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  Read the cotisations to pay under Compte, Paiement, Payer les cotisations.

  Step 2

  Keep the échéances that were not there on the last run.

  Step 3

  Post period, amount due and due date to your accounting system's webhook.

• Échéances of your délais de paiement due this week

  Build this

  Starts

  Every Monday at 7:30

  Step 1

  Read your délais de paiement accordés with each échéance.

  Step 2

  Keep the échéances due in the next 7 days.

  Step 3

  Email you the list with the délai, due date and amount.

• A fresh attestation de vigilance for your clients

  Build this

  Starts

  On the 1st of every month at 8:00

  Step 1

  Get an attestation de vigilance from Documents.

  Step 2

  Email you its issue date and 15-character security code, or that Urssaf will email it later.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get an attestation de vigilance” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "www.urssaf.fr/get_attestation_de_vigilance",
    "input": {}
  }'

{
  "status": "completed",
  "data": {
    "company_name": "Northwind Services SAS",
    "siret": "00000000000017",
    "issue_date": "2026-11-12",
    "security_code": "A1B2C3D4E5F6G7H",
    "available_now": true
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The Urssaf espace en ligne’s own options

Urssaf's Portail API lists APIs for third-party declaration (auto-entrepreneur, Cesu, PAJE), the DPAE, international mobility and Tiers de prestations, most with Accès restreint, plus a public API that checks an attestation's security code. Its catalogue lists no API for the employer espace en ligne itself. Employers declare by DSN, for example on net-entreprises.fr.

Read on November 12, 2026: Portail API Urssaf: catalogue des API, Employeur : comment payer par télépaiement ?, Comment créer votre espace en ligne sur urssaf.fr.

Signing in to the Urssaf espace en ligne

You click Se connecter on urssaf.fr, select the profile Employeur du secteur privé, and sign in with your identifiant and a password of 10 to 64 characters, set from a link Urssaf emails when the espace is created. With Fous you sign in once with your own account, the login is sealed with AES-256 and never shown to code or AI agents, and when a session expires Fous signs back in.

Worth knowing

Attestations are not always immediate

When an attestation de vigilance cannot be downloaded at once, Urssaf emails you when it is ready in your espace en ligne. Plan for a second run to read it.

Clients check it every 6 months

The attestation de vigilance is required for contracts of 5,000 € excluding tax or more. The donneur d'ordre checks it at signing and then every 6 months, with its 15-character security code.

Payment follows the validated DSN

The échéance en cours is paid from Compte, Paiement, Payer les cotisations once your DSN is validated. Télépaiement needs bank details and a Sepa mandate under Mon profil, Moyens de paiements.

Délai requests have conditions

Cotisations salariales must be paid in full before you can ask for a délai. A first request with one late period can be accepted automatically; other requests go to a gestionnaire.

More in Government: UK and Western Europe

• Guichet unique des formalités d'entreprises
• Companies House WebFiling
• Planning Portal
• Chorus Pro
• FCA RegData
• net-entreprises.fr
• ePortal ESTV
• FinanzOnline
• impots.gouv.fr espace professionnel
• MOT Testing Service

Other industries: webDEALER, Simplifile, Wide Area Workflow, Cal eProcure, INTIME, SIDES E-Response.