# Get your Urssaf employer account through an API

> Download your attestation de vigilance and read the cotisations to pay and your délais de paiement accordés from your Urssaf espace en ligne with one API call each. Or have a workflow check the Compte section every morning and hand new échéances to accounting.

Page: https://fous.com/automate/urssaf-compte-employeur
Updated: 2026-11-12

Works with your own Urssaf compte employeur account. Fous is an independent product.

## What you can build on the Urssaf espace en ligne

### Get an attestation de vigilance

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

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

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

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](/product/workflows) 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

Starts: Every weekday at 8:00

1. Read the cotisations to pay under Compte, Paiement, Payer les cotisations.
2. Keep the échéances that were not there on the last run.
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

Starts: Every Monday at 7:30

1. Read your délais de paiement accordés with each échéance.
2. Keep the échéances due in the next 7 days.
3. Email you the list with the délai, due date and amount.

### A fresh attestation de vigilance for your clients

Starts: On the 1st of every month at 8:00

1. Get an attestation de vigilance from Documents.
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](/product/methods), 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.

Example request:

```
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": {}
  }'
```

Example response:

```
{
  "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.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Portail API Urssaf | Tierce Déclaration APIs, API DPAE, API Mobilité internationale, API Tiers de prestations. Not the Compte, Documents or messagerie of the espace en ligne. | Accès restreint for most of them, as the Portail API catalogue marks each one. |
| API Attestations Vérification Code Sécurité | Checks that an attestation produced by Urssaf is valid, from its security code. | Accès public, listed in the Portail API catalogue. |
| DSN through net-entreprises.fr | Your DSN declarations. Urssaf's payment service opens from Vos services complémentaires, then Sites partenaires. | Filing your DSN on net-entreprises.fr. |
| The espace en ligne by hand | Tableau de bord, Compte, Documents, délais de paiement, bank details and the messagerie sécurisée. | Your identifiant and password. Free, open 24 hours a day, 7 days a week. |

Read on November 12, 2026: [Portail API Urssaf: catalogue des API](https://portailapi.urssaf.fr/fr/catalogue-api), [Employeur : comment payer par télépaiement ?](https://www.urssaf.fr/accueil/services/services-employeurs/comment-payer-par-telepaiment.html), [Comment créer votre espace en ligne sur urssaf.fr](https://www.urssaf.fr/accueil/services/comment-creer-espace-en-ligne.html).

## 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](https://fous.com/automate/guichet-unique-des-formalites-d-entreprises.md)
- [Companies House WebFiling](https://fous.com/automate/companies-house-webfiling.md)
- [Planning Portal](https://fous.com/automate/planning-portal.md)
- [Chorus Pro](https://fous.com/automate/chorus-pro.md)
- [FCA RegData](https://fous.com/automate/fca-regdata.md)
- [net-entreprises.fr](https://fous.com/automate/net-entreprises-fr.md)
- [ePortal ESTV](https://fous.com/automate/eportal-estv.md)
- [FinanzOnline](https://fous.com/automate/finanzonline.md)
- [impots.gouv.fr espace professionnel](https://fous.com/automate/impots-gouv-fr-espace-professionnel.md)
- [MOT Testing Service](https://fous.com/automate/mot-testing-service.md)

Other industries: [webDEALER](/automate/webdealer), [Simplifile](/automate/simplifile), [Wide Area Workflow](/automate/wide-area-workflow), [Cal eProcure](/automate/cal-eprocure), [INTIME](/automate/intime), [SIDES E-Response](/automate/sides-e-response).

## Frequently asked questions

### Does the Urssaf employer account have an API?

Not for the espace en ligne itself. Urssaf's Portail API covers third-party declaration, the DPAE, international mobility and Tiers de prestations, mostly with Accès restreint, and a public API that checks an attestation's security code. Declarations go by DSN.

### Can I get my attestation de vigilance automatically?

Yes, with a method that does what you do in Documents: Demander une attestation, attestation de vigilance, Valider, Voir le fichier. When Urssaf cannot issue it at once, it emails you when the attestation is ready.

### How can a client check my attestation?

With the 15-character security code printed on it. Urssaf's public API Attestations Vérification Code Sécurité checks an attestation's validity from that code.

### Can a method pay my cotisations?

Yes, if you build one: Payer les cotisations is in your own account, and a method does only what your account can. Télépaiement first needs your bank details and a Sepa mandate under Mon profil, Moyens de paiements.

### Is Fous affiliated with Urssaf Caisse nationale?

No. Fous is an independent product. It works with your own Urssaf account and signs in through Urssaf's own sign-in page.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Urssaf compte employeur (Urssaf Caisse nationale). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.