EUREG Documentation

Quickstart

Get your API key and make your first request in under 2 minutes.

1. Get an API key

Create a free account and generate an API key from your dashboard. Your key will look like eureg_live_a3f8...

2. Make your first request

Fetch the latest announcements from Spain:

cURLbash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.eureg.io/api/v1/announcements?jurisdiction=ES&per_page=5"

3. Parse the response

The API returns paginated JSON:

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "source_id": "es_boe",
      "publication_date": "2025-01-15",
      "jurisdiction": "ES",
      "category": "company_formation",
      "title": "Constitucion de Sociedad...",
      "entities": [
        {"type": "company", "name": "Example SL", "role": "subject"}
      ],
      "metadata": {"capital": 3000, "currency": "EUR"}
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 5,
    "total": 12345,
    "total_pages": 2469
  }
}

4. Using Python

Pythonpython
import requests

API_KEY = "eureg_live_your_key_here"
BASE_URL = "https://api.eureg.io/api/v1"

response = requests.get(
    f"{BASE_URL}/announcements",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"jurisdiction": "ES", "category": "insolvency_filing"},
)

data = response.json()
for item in data["data"]:
    print(f"{item['publication_date']}: {item['title']}")

5. Using JavaScript

JavaScriptjavascript
const API_KEY = "eureg_live_your_key_here";
const BASE_URL = "https://api.eureg.io/api/v1";

const response = await fetch(
  `${BASE_URL}/announcements?jurisdiction=FR&per_page=10`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);

const { data, pagination } = await response.json();
console.log(`Found ${pagination.total} announcements`);
data.forEach(item => console.log(item.title));

Next steps