Free SIRET API — RandomSiret Documentation

Endpoint Reference

GET https://www.randomsiret.fr/api/v1/generate

Parameters

Parameter	Type	Default	Description
`quantity`	integer	`5`	Number of SIRETs to generate (max 50)

Response example

{
  "count": 2,
  "data": [
    {
      "siret": "292 902 293 00615",
      "siren": "292 902 293",
      "company": "Salmon Faure SA",
      "street_address": "3, boulevard de Loiseau",
      "city": "Lyon",
      "postcode": "69001"
    },
    {
      "siret": "720 036 680 83592",
      "siren": "720 036 680",
      "company": "Schneider et Fils",
      "street_address": "7, impasse Duval",
      "city": "Paris",
      "postcode": "75011"
    }
  ],
  "meta": {
    "generated_at": "2026-03-17T10:00:00+01:00",
    "source": "randomsiret.fr",
    "rate_limit_remaining_minute": 9,
    "rate_limit_remaining_day": 98
  }
}

Rate limit response (429)

HTTP/1.1 429 Too Many Requests

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Limit: 10 per minute.",
  "retry_after": 45,
  "upgrade": "https://www.randomsiret.fr/en/pricing"
}

Code Examples

curl "https://www.randomsiret.fr/api/v1/generate?quantity=5"

const response = await fetch(
  'https://www.randomsiret.fr/api/v1/generate?quantity=5'
);
const { data } = await response.json();

data.forEach(entry => {
  console.log(entry.siret, entry.company, entry.city);
});

import requests

response = requests.get(
    'https://www.randomsiret.fr/api/v1/generate',
    params={'quantity': 5}
)
data = response.json()['data']

for entry in data:
    print(entry['siret'], entry['company'], entry['city'])

<?php

$response = file_get_contents(
    'https://www.randomsiret.fr/api/v1/generate?quantity=5'
);
$result = json_decode($response, true);

foreach ($result['data'] as $entry) {
    echo $entry['siret'] . ' — ' . $entry['company'] . PHP_EOL;
}

Use Cases

Automated testing

Populate your test fixtures with realistic French company data.

Demo data

Fill your demo databases with geolocated fictional companies.

Form validation

Test your SIRET validators with algorithmically correct numbers.

Training & documentation

Illustrate your tutorials and docs with concrete examples without real data.

Limits & Unlimited Access

	Free	Lifetime Pass
Requests / minute	10	Unlimited
Requests / day	100	Unlimited
Max quantity per request	50	100
API key required	No	No
CSV Export	—	✓

Need more?

The lifetime pass gives unlimited API access and CSV exports.

See pricing

Try it Live

quantity

GET /api/v1/generate?quantity=3

Click "Send request" to see the response...