Sanctions screening and risk profile

Compliance endpoints: the risk profile of a Spanish company and sanctions screening of companies and people.

Base URL: https://spaincompanyapi.com/api/v1 · API key in the X-API-KEY header · Get a free API key (100 requests, no card) · Full documentation

10. Corporate Risk Profile (Business Plan Only)

Returns the corporate risk profile, registry compliance (annual accounts filing), governance stability, capital volatility, and official distress alerts associated with a company by CIF. Designed to automate credit scoring, solvency checks, and compliance in B2B onboarding workflows.

GET /companies/risk-profile Business
ParameterTypeRequiredDescription
cifstringRequiredCompany CIF/NIF to audit (e.g. A01001411 or A15075062 in Sandbox).

Success response (200 OK - Business Plan)

{
  "success": true,
  "data": {
    "cif": "A01001411",
    "company_name": "RHEINMETALL EXPAL MUNITIONS SA",
    "risk_score": 62,
    "risk_level": "ALTO",
    "confidence_score": 49,
    "data_quality_score": 70,
    "summary_message": "Atención: Constan indicadores de elevado riesgo financiero o corporativo.",
    "legal_state": "REGISTRY_CLOSURE_GENERICO",
    "data_sources": {
      "borme_status": "CHECKED_WITH_RECORDS",
      "accounts_status": "KNOWN_DELAYED",
      "official_status": "KNOWN"
    },
    "dimensions": {
      "legal_distress": 60,
      "filing_compliance": 0,
      "governance_volatility": 30,
      "capital_instability": 0,
      "structural_volatility": 0,
      "stabilizing_credit": 0
    },
    "canonical_events": [
      {
        "code": "LEGAL_STATE_REGISTRY_CLOSURE_GENERICO",
        "dimension": "legal_distress",
        "severity": "high",
        "description": "Consta publicación registral de cierre sin especificación de causa.",
        "event_date": "2026-08-24",
        "classification_confidence": "LOW"
      }
    ],
    "model_version": "2.0.0",
    "calculated_at": "2026-08-24T00:00:00Z"
  }
}

Plan restricted response (403 Forbidden - Free & Pro Plans)

{
  "success": false,
  "error": "PLAN_RESTRICTION",
  "message": "El acceso al perfil de riesgo corporativo requiere el plan Business.",
  "upsell_opportunities": {
    "mensaje": "Nivel de riesgo de esta empresa: MEDIO. Con el plan Business ves la puntuación, las seis dimensiones, el estado legal y cada evento del BORME que lo explica.",
    "upgrade_url": "https://apiempresas.es/billing?plan=business&source=api_403_risk",
    "perfil_disponible": true,
    "nivel_riesgo": "MEDIO"
  }
}

nivel_riesgo only appears on paid plans; on Free you only get whether a profile exists (perfil_disponible). Up to 25 responses with this summary per account per day.

FieldTypeDescription
risk_scoreinteger (0-100)Consolidated algorithmic risk rating (higher values denote higher default or distress risk).
risk_levelstringQualitative risk grade: BAJO, MEDIO, ALTO, CRITICO.
dimensionsobjectDetailed breakdown of risk factors: legal distress, filing compliance, governance changes, capital instability and credit mitigation.
canonical_events[]array[object]Chronological list of official corporate and mercantile registry events with severity assessment.

10.1 Sanctions Screening (Business only)

Checks whether a Spanish company and its current directors, or any name, appear on the sanctions lists of the European Union (consolidated financial sanctions list, binding in Spain), the United Nations (Security Council consolidated list) and OFAC (US SDN list). The lists are updated daily.

Each match has a similarity level: strong (0.92 or more: same name, possibly in another order or transliteration) or possible (0.85 or more: similar, or the searched name is contained in the listed one). To confirm or rule it out, compare the date of birth, country and documents included in the list.

GET /sanctions/screen Business

When screening a person's name, send it in the body: POST /sanctions/screen with {"name": "…", "type": "person"}. The screened name is not stored in our request log.

ParameterTypeRequiredDescription
cifstringOne of the twoCompany CIF: checks the legal name and its current directors (excluding auditors and attorneys, up to 40).
namestringOne of the twoName of a person or entity, instead of cif (3-200 characters).
typestringOptionalWith name: person, entity or any (default).
directorsbooleanOptionalWith cif: false to check only the company. Default true.
curl "https://spaincompanyapi.com/api/v1/sanctions/screen?name=Vladimir%20Putin&type=person" -H "X-API-KEY: your_api_key"

Response for a name (200 OK - Business plan)

{
  "success": true,
  "data": {
    "query": { "name": "Vladimir Putin", "type": "person" },
    "matches": [
      {
        "level": "strong",
        "score": 1,
        "list": "OFAC",
        "matched_name": "Vladimir PUTIN",
        "listed_name": "Vladimir Vladimirovich PUTIN",
        "entry_type": "person",
        "programs": ["RUSSIA-EO14024"],
        "listed_on": null,
        "countries": ["Russia"],
        "birth_dates": ["07 Oct 1952"],
        "identifiers": [],
        "reference": "35096",
        "url": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=35096"
      }
    ],
    "summary": { "strong_matches": 2, "possible_matches": 0, "result": "match" },
    "lists": [
      { "list": "EU", "description": "Unión Europea: lista consolidada de sanciones financieras", "entries": 6234, "list_date": "2026-10-15", "loaded_at": "2026-10-18T11:52:34+00:00" },
      { "list": "OFAC", "description": "EE. UU. (OFAC): Specially Designated Nationals (SDN)", "entries": 19457, "list_date": "2026-10-15", "loaded_at": "2026-10-18T11:53:07+00:00" },
      { "list": "UN", "description": "Naciones Unidas: lista consolidada del Consejo de Seguridad", "entries": 1010, "list_date": "2026-10-17", "loaded_at": "2026-10-18T11:53:01+00:00" }
    ],
    "checked_at": "2026-10-18T11:55:44+00:00",
    "note": "Una coincidencia por nombre no confirma que sea la misma persona o entidad: compara la fecha de nacimiento, el país y los documentos de la lista antes de decidir."
  }
}

Response for a CIF

curl "https://spaincompanyapi.com/api/v1/sanctions/screen?cif=A46103834" -H "X-API-KEY: your_api_key"
{
  "success": true,
  "data": {
    "company": { "cif": "A46103834", "name": "MERCADONA SA", "matches": [] },
    "directors": [],
    "summary": { "directors_checked": 9, "strong_matches": 0, "possible_matches": 0, "result": "clear", "directors_included": true },
    "lists": [ "..." ],
    "checked_at": "2026-10-18T11:55:45+00:00"
  }
}
  • summary.result: clear (no matches), possible_match (only possible ones) or match (at least one strong).
  • With cif, directors only lists directors with a match: name, position and matches, with the same fields as above.
  • It is also included in KYB verification on Business, under checks.sanctions: a strong match for the company or a director sets decision_hint to review.
  • It supports due diligence; it is not a certificate. The final decision and identity check are yours.

Restricted response (403 Forbidden - Free and Pro plans)

{
  "success": false,
  "error": "PLAN_RESTRICTION",
  "message": "La comprobación en listas de sanciones requiere el plan Business.",
  "required_plan": "business",
  "upsell_opportunities": {
    "mensaje": "Con el plan Business ves cada coincidencia en las listas de la UE, la ONU y OFAC, con su grado de parecido, programa de sanciones, fecha, país y fecha de nacimiento, también para los administradores.",
    "upgrade_url": "https://apiempresas.es/billing?plan=business&source=api_403_sanctions",
    "listas": ["EU (6234 entradas, lista del 2026-10-15)", "OFAC (19457 entradas, lista del 2026-10-15)", "UN (1010 entradas, lista del 2026-10-17)"]
  }
}

The 403 does not use queries or reveal the result. Cost on Business: 1 query per call.

🚀 Ready to get started?

Get your API Key in seconds and start integrating real data into your applications.

Go to Control Panel
🤖
Asistente IA En línea
¡Hola! Soy el asistente de APIEmpresas. ¿En qué puedo ayudarte hoy?