---
title: "Search insolvency / risk notices"
method: GET
path: "/search"
tags: ["Insolvency"]
---

# Search insolvency / risk notices

`GET /search`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/search`
- Auth: HTTP bearer

Search registry risk notices by company name, VAT/NIF (Spain), SIREN/SIRET (France), or company_number (UK). Returns insolvency filings, dissolutions, liquidations, and other risk-relevant events extracted from official gazettes. At least one of `name`, `vat`, `siren`, `siret`, or `company_number` is required.

## Query parameters

- `country` 'ES' | 'FR' | 'GB' | 'IE' | 'PL' | 'NO' | 'FI' | 'SE' | 'HR' | 'BE' | 'DK' | 'EE' | 'SK' | 'CH' | 'LV' | 'CY' | 'RO' | 'LT' | 'CA' | 'AU' | 'JP' | 'IL' | 'BR' | 'CO' | 'SG' | 'TW' | 'CZ' | 'DE' | 'US'
- `name` string
- `vat` string
- `siren` string
- `siret` string
- `company_number` string
- `event_type` 'insolvency' | 'dissolution' | 'liquidation' | 'restructuring' | 'status_change'
- `date_from` string, date
- `date_to` string, date
- `limit` integer
- `cursor` string

## Response `200`

Search results

- object
  - `data` Notice[]
    - `id` integer
    - `company_name` string
    - `company_number` string, nullable
    - `vat_number` string, nullable
    - `country` 'ES' | 'FR' | 'GB' | 'IE' | 'PL' | 'NO'
    - `status` string, nullable: Standard status of the proceeding: insolvency-proceedings, liquidation, winding-up, restructuring, administration, receivership, forced-sale or concluded.
    - `local_status` string, nullable: The original wording of the source (for example "Konkurs: Dekret"). Renamed from `status_detail` on 6 October 2026.
    - `event_type` string, nullable
    - `filing_date` string, date
    - `source` string
    - `notice_url` string, uri, nullable
    - `created_at` string, date-time
  - `pagination` Pagination
    - `count` integer: Number of items in this response
    - `has_more` boolean
    - `next_cursor` string, nullable: Pass as `cursor` to fetch the next page
  - `meta` Meta
    - `query_ms` integer
    - `search_mode` string
    - `country` 'ES' | 'FR' | 'GB' | 'IE' | 'PL' | 'NO' | 'FI' | 'SE' | 'HR' | 'BE' | 'DK' | 'EE' | 'SK' | 'CH' | 'LV' | 'CY' | 'RO' | 'LT' | 'CA' | 'AU' | 'JP' | 'IL' | 'BR' | 'CO' | 'SG' | 'TW' | 'CZ' | 'DE' | 'US'
    - `rate_limit` RateLimitMeta
      - `rpm_remaining` integer
      - `daily_remaining` integer

## Other responses

- `400`: Missing or invalid parameters
- `401`: Missing, invalid, or expired API key
- `403`: Key lacks the required scope or country access
- `429`: Rate limit exceeded — see `Retry-After` header for seconds until reset
- `500`: Unexpected server error — safe to retry with exponential backoff

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/fb8b4de5b18d?raw)