Developers

Your first call in five minutes

Run one live call now, then choose how you want to build.

Run a call

curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=inditex&country=ES&limit=1" \
  -H "Authorization: Bearer rk_live_demo_publichn"
Public demo key, shared, about 30 calls an hour. A key of your own is not shared.
Customer dashboard screenshot: company search resultsCustomer dashboard screenshot: company search results
The same search in the dashboard, as a table: GET /companies/search without code (1 credit). Open it in the dashboard

Choose how to build

  • InstallTypeScript, Python or the MCP server: one line each.npm install prometiam-risk-apipip install prometiam-risk-apinpx -y prometiam-risk-mcpRead the guide →
  • ImportThe OpenAPI 3.0 file, and a Postman collection with one request per endpoint.Download OpenAPI 3.0Download the collectionRun in Postman ↗
  • Ask your assistantAdd the server to Claude, Cursor or VS Code with no key, then ask for a company.
    {
      "mcpServers": {
        "prometiam-risk": {
          "command": "npx",
          "args": ["-y", "prometiam-risk-mcp"]
        }
      }
    }
    Read the guide →

Know before you build

Base URL
https://api.prometiam.com/functions/v1/risk-api
Authentication
Authorization: Bearer YOUR_KEY
Rate limits
Trial 10 · Starter 60 · Professional 120 · Scale 300 requests a minute, by plan
Credits
1 · 2 · 3 · 25 credits per successful call, listed below; errors are free
Pagination
Lists page with a cursor: send the next_cursor of a response as the cursor of the next request.
Batch calls
Every item counts as one request; an over-quota batch is refused up front with 429 batch_exceeds_quota. Send an Idempotency-Key to retry safely.

Every integration calls the same API with the same key. A successful call costs credits; errors are free, and each response states its cost in the X-Credits-Cost header.

CreditsCalls
1Company search or record, lookup item, VAT, LEI
2Events, people, director network, insolvency
3Sanctions screen (beta), per name
25Financial statements of one company

Limits that apply everywhere

  • Sanctions screening is beta. PEP screening is beta and Spain only.
  • Insolvency notices are corporate only, in sixteen markets.
  • Monitoring covers every live country except France and Chile.
  • Officers are served for Spain, France, the United Kingdom, Norway and Poland (Polish natural persons are masked by the register). Every other country is company records only.

Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.

Get your own key

Card required. Nothing charged for 14 days.

Start your 14-day free trial →Card required. Nothing charged for 14 days.