{ "info": { "_postman_id": "8c5e2a1b-7d3a-4f5a-9e2c-1b2a3d4f5a02", "name": "APIEmpresas.es - Plan Pro", "description": "Colección de la API de APIEmpresas.es organizada por planes (Free, Pro y Business). Pon tu clave en la variable API_KEY. BASE_URL apunta a producción; cámbiala a https://apiempresas.es/api/sandbox/v1 para probar sin gastar consultas. Cada petición trae un ejemplo de respuesta. Referencia completa: https://apiempresas.es/api/referencia. Actualizada el 13-10-2026.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "1. Plan Free", "item": [ { "name": "Consulta por CIF", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies" ], "query": [ { "key": "cif", "value": "A15075062" } ] }, "description": "Datos básicos y status_code. En Free, dirección y objeto social van recortados. Coste: 1 consulta." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies" ], "query": [ { "key": "cif", "value": "A15075062" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"B12345678\",\n \"name\": \"EMPRESA DE EJEMPLO SL\",\n \"status\": \"ACTIVA\",\n \"status_code\": \"ACTIVE\",\n \"status_source\": \"registry\",\n \"status_date\": \"2011-02-03\",\n \"tax_id_revocation\": null,\n \"province\": \"MADRID\",\n \"cnae\": \"6201\",\n \"cnae_label\": \"Actividades de programación informática\",\n \"financials\": {\n \"size_band\": \"GT_1M\",\n \"size_band_label\": \"Más de 1 M€\",\n \"last_accounts_year\": 2023\n },\n \"identifiers\": {\n \"lei\": \"5493000EJEMPLO000000\",\n \"lei_status\": \"ISSUED\",\n \"lei_next_renewal_date\": \"2027-03-15\",\n \"lei_source\": \"gleif\",\n \"lei_as_of\": \"2026-10-15\"\n },\n \"legal_form\": {\n \"code\": \"SL\",\n \"label\": \"Sociedad limitada\",\n \"iso20275\": \"DP3Q\",\n \"source\": \"name\"\n },\n \"group\": {\n \"direct_parent\": {\n \"lei\": \"5493000MATRIZ0000000\",\n \"name\": \"GRUPO EJEMPLO SA\",\n \"country\": \"ES\",\n \"cif\": \"A12345674\"\n },\n \"ultimate_parent\": {\n \"lei\": \"5493000MATRIZ0000000\",\n \"name\": \"GRUPO EJEMPLO SA\",\n \"country\": \"ES\",\n \"cif\": \"A12345674\"\n },\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"ownership\": {\n \"unipersonal\": true,\n \"sole_shareholder\": {\n \"name\": \"GRUPO EJEMPLO SA\",\n \"type\": \"company\",\n \"since\": \"2021-06-14\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf\"\n },\n \"source\": \"borme\",\n \"as_of\": \"2021-06-14\"\n },\n \"size\": {\n \"employees_min\": 10,\n \"employees_max\": 49,\n \"label\": \"De 10 a 49 empleados\",\n \"category\": \"small\",\n \"source\": \"kit_digital\",\n \"as_of\": \"2024-05-14\"\n },\n \"address_density\": {\n \"active_companies_at_address\": 63,\n \"level\": \"mass\",\n \"match\": \"exact_address\",\n \"as_of\": \"2026-10-19\"\n },\n \"sources\": {\n \"registry\": {\n \"source\": \"borme\",\n \"as_of\": \"2026-09-22\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2026/09/22/pdfs/BORME-A-2026-180-28.pdf\",\n \"fields\": [\n \"name\",\n \"founded\",\n \"corporate_purpose\"\n ]\n },\n \"status\": {\n \"source\": \"registry\",\n \"as_of\": \"2011-02-03\"\n },\n \"identifiers\": {\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"legal_form\": {\n \"source\": \"name\",\n \"as_of\": null\n },\n \"group\": {\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"ownership\": {\n \"source\": \"borme\",\n \"as_of\": \"2021-06-14\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf\"\n },\n \"size\": {\n \"source\": \"kit_digital\",\n \"as_of\": \"2024-05-14\"\n },\n \"address_density\": {\n \"source\": \"apiempresas\",\n \"as_of\": \"2026-10-19\"\n },\n \"administrators\": {\n \"source\": \"borme\",\n \"as_of\": \"2026-09-22\"\n }\n },\n \"administrators\": [\n {\n \"name\": \"JUAN PÉREZ GARCÍA\",\n \"position\": \"Adm. Unico\",\n \"since\": \"2019-03-01\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2019/03/01/pdfs/BORME-A-2019-42-28.pdf\"\n }\n ]\n }\n}" } ] }, { "name": "Búsqueda por Nombre", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/search?q=mercadona", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "search" ], "query": [ { "key": "q", "value": "mercadona" } ] }, "description": "Añade multiple=true&limit=20 para varios resultados. Coste: 1 consulta (1 crédito con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/search?q=mercadona", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "search" ], "query": [ { "key": "q", "value": "mercadona" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"cif\": \"B12345678\",\n \"name\": \"EMPRESA DE EJEMPLO SL\",\n \"status\": \"ACTIVA\",\n \"province\": \"MADRID\"\n }\n ],\n \"meta\": {\n \"page\": 1,\n \"limit\": 20,\n \"has_more\": false\n }\n}" } ] }, { "name": "Scoring Comercial (básico)", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/score?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "score" ], "query": [ { "key": "cif", "value": "A15075062" } ] }, "description": "En Free, solo la puntuación; el desglose va en Pro. No gasta consultas (máximo 25 vistas previas al día), pero hace falta que te quede alguna." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/score?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "score" ], "query": [ { "key": "cif", "value": "A15075062" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"B12345678\",\n \"score\": 82,\n \"priority\": \"muy_alta\",\n \"reasons\": [\n \"OPP:95|QUAL:80|CONT:60 · Ampliación de capital\"\n ],\n \"last_signal\": {\n \"type\": \"Ampliación de capital\",\n \"date\": \"2026-09-15\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2026/09/15/pdfs/BORME-A-2026-176-15.pdf\"\n },\n \"source\": \"radar\"\n }\n}" } ] }, { "name": "Empresas recién constituidas", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/radar?range=7", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "radar" ], "query": [ { "key": "range", "value": "7" } ] }, "description": "En Free, 10 resultados con nombre y CIF ocultos. Coste: 1 consulta del plan (3 créditos con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/radar?range=7", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "radar" ], "query": [ { "key": "range", "value": "7" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"meta\": {\n \"plan\": \"business\",\n \"count\": 50,\n \"limit\": 1000,\n \"total_disponibles\": 50\n },\n \"data\": [\n {\n \"id\": 4812345,\n \"company_name\": \"NUEVA EMPRESA SL\",\n \"cif\": \"B12345678\",\n \"fecha_constitucion\": \"2026-10-13\",\n \"cnae\": \"6201\",\n \"cnae_label\": \"Actividades de programación informática\",\n \"registro_mercantil\": \"MADRID\",\n \"municipality\": \"MADRID\",\n \"score_total\": 78,\n \"priority_level\": \"alta\",\n \"main_act_type\": \"Constitución\"\n }\n ]\n}" } ] }, { "name": "Estadísticas del BORME", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/stats?province=MADRID&metrics=incorporations,extinctions,insolvencies&from=2026-01", "host": [ "{{BASE_URL}}" ], "path": [ "stats" ], "query": [ { "key": "province", "value": "MADRID" }, { "key": "metrics", "value": "incorporations,extinctions,insolvencies" }, { "key": "from", "value": "2026-01" } ] }, "description": "Constituciones, disoluciones, extinciones, concursos y otros actos del BORME por mes o año, para España o una provincia. Todos los planes. Coste: 1 consulta (3 créditos con bono). No está en el Sandbox." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/stats?province=MADRID&metrics=incorporations,extinctions,insolvencies&from=2026-01", "host": [ "{{BASE_URL}}" ], "path": [ "stats" ], "query": [ { "key": "province", "value": "MADRID" }, { "key": "metrics", "value": "incorporations,extinctions,insolvencies" }, { "key": "from", "value": "2026-01" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"province\": \"MADRID\",\n \"province_code\": \"28\",\n \"group\": \"month\",\n \"from\": \"2026-08\",\n \"to\": \"2026-10\",\n \"totals\": {\n \"incorporations\": 4210,\n \"extinctions\": 1187\n },\n \"series\": [\n {\n \"period\": \"2026-08\",\n \"incorporations\": 1085,\n \"extinctions\": 312\n },\n {\n \"period\": \"2026-09\",\n \"incorporations\": 1912,\n \"extinctions\": 523\n },\n {\n \"period\": \"2026-10\",\n \"incorporations\": 1213,\n \"extinctions\": 352\n }\n ]\n },\n \"meta\": {\n \"source\": \"borme\",\n \"last_borme_date\": \"2026-10-16\",\n \"computed_at\": \"2026-10-16 21:05:12\",\n \"notes\": \"Actos publicados en el BORME (sección A) por la fecha del boletín y la provincia del Registro. El mes en curso está incompleto. Un acto con varios tipos cuenta en cada uno.\"\n }\n}" } ] }, { "name": "Segmentos: recuento (gratis)", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/filter?cnae=62&province=MADRID&has_phone=true&count_only=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "filter" ], "query": [ { "key": "cnae", "value": "62" }, { "key": "province", "value": "MADRID" }, { "key": "has_phone", "value": "true" }, { "key": "count_only", "value": "true" } ] }, "description": "Cuántas empresas encajan con los filtros. Gratis en todos los planes. Filtros: cnae, province, municipality, status (active, active_or_unknown, any), founded_from, founded_to, has_phone, size_band (NO_REVENUE, LT_500K, 500K_1M, GT_1M), min_accounts_year. Hace falta cnae, province o municipality." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/filter?cnae=62&province=MADRID&has_phone=true&count_only=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "filter" ], "query": [ { "key": "cnae", "value": "62" }, { "key": "province", "value": "MADRID" }, { "key": "has_phone", "value": "true" }, { "key": "count_only", "value": "true" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"total\": 3412\n },\n \"meta\": {\n \"filters\": {\n \"cnae\": [\n \"62\"\n ],\n \"province\": \"MADRID\",\n \"status\": \"active\",\n \"has_phone\": true\n },\n \"cost\": 0,\n \"counted_at\": \"2026-09-29T09:30:00+02:00\"\n }\n}" } ] }, { "name": "Estadísticas de Consumo", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/usage", "host": [ "{{BASE_URL}}" ], "path": [ "usage" ] }, "description": "No gasta consultas." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/usage", "host": [ "{{BASE_URL}}" ], "path": [ "usage" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"stats\": {\n \"monthly_queries\": 150,\n \"total_queries\": 1250,\n \"monthly_quota\": 3000,\n \"remaining_calls\": 2850,\n \"wallet_balance\": 0,\n \"plan_name\": \"Pro\",\n \"plan_slug\": \"pro\",\n \"quota_period\": \"monthly\"\n },\n \"history\": [\n {\n \"cif\": \"A46103834\",\n \"name\": \"MERCADONA SA\",\n \"province\": \"VALENCIA\",\n \"query_count\": 3,\n \"last_query\": \"2026-10-12 17:40:02\",\n \"found\": true\n }\n ]\n }\n}" } ] }, { "name": "Catálogo de valores de los filtros", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog", "host": [ "{{BASE_URL}}" ], "path": [ "catalog" ] }, "description": "Valores válidos de province, size_band, status, range, priority y main_act_type, eventos de webhook y tipos de evento de la vigilancia. Gratis en todos los planes." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/catalog", "host": [ "{{BASE_URL}}" ], "path": [ "catalog" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"province\": [\n \"A CORUÑA\",\n \"ÁLAVA\",\n \"ALBACETE\",\n \"…\",\n \"ZARAGOZA\"\n ],\n \"cnae\": {\n \"format\": \"Prefijos de la CNAE-2009 (INE) de 1 a 4 dígitos, separados por comas: 62 o 4711,4719.\",\n \"count\": \"/companies/filter?cnae=62&count_only=true (gratis) dice cuántas empresas hay.\"\n },\n \"size_band\": [\n {\n \"value\": \"NO_REVENUE\",\n \"label\": \"Sin ventas\"\n },\n {\n \"value\": \"LT_500K\",\n \"label\": \"Menos de 0,5 M€\"\n },\n {\n \"value\": \"500K_1M\",\n \"label\": \"Entre 0,5 y 1 M€\"\n },\n {\n \"value\": \"GT_1M\",\n \"label\": \"Más de 1 M€\"\n }\n ],\n \"status\": [\n \"active\",\n \"active_or_unknown\",\n \"any\"\n ],\n \"radar\": {\n \"range\": [\n \"hoy\",\n \"7\",\n \"30\"\n ],\n \"range_note\": \"'hoy' o cualquier número de días atrás\",\n \"priority\": [\n \"muy_alta\",\n \"alta\",\n \"media\",\n \"baja\",\n \"muy_baja\"\n ],\n \"main_act_type\": [\n \"Constitución\",\n \"Nombramientos\",\n \"Ampliación de Capital\",\n \"…\"\n ]\n },\n \"score_priority\": [\n \"muy_alta\",\n \"alta\",\n \"media\",\n \"baja\",\n \"muy_baja\"\n ],\n \"webhook_events\": [\n \"test.ping\",\n \"company.created\",\n \"company.borme_act\",\n \"company.status_changed\",\n \"company.risk_level_changed\",\n \"company.insolvency\",\n \"watchlist.*\"\n ],\n \"watchlist_event_types\": [\n \"borme_act\",\n \"status_change\",\n \"risk_level_change\",\n \"insolvency\"\n ]\n },\n \"meta\": {\n \"updated_at\": \"2026-10-13\",\n \"cost\": 0\n }\n}" } ] }, { "name": "Sandbox: Consulta por CIF", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "https://apiempresas.es/api/sandbox/v1/companies?cif=A15075062&admin=true", "protocol": "https", "host": [ "apiempresas", "es" ], "path": [ "api", "sandbox", "v1", "companies" ], "query": [ { "key": "cif", "value": "A15075062" }, { "key": "admin", "value": "true" } ] }, "description": "Respuestas de ejemplo. Solo acepta A15075062 (éxito) y B00000000 (no encontrada). No gasta consultas." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "https://apiempresas.es/api/sandbox/v1/companies?cif=A15075062&admin=true", "protocol": "https", "host": [ "apiempresas", "es" ], "path": [ "api", "sandbox", "v1", "companies" ], "query": [ { "key": "cif", "value": "A15075062" }, { "key": "admin", "value": "true" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"B12345678\",\n \"name\": \"EMPRESA DE EJEMPLO SL\",\n \"status\": \"ACTIVA\",\n \"status_code\": \"ACTIVE\",\n \"status_source\": \"registry\",\n \"status_date\": \"2011-02-03\",\n \"tax_id_revocation\": null,\n \"province\": \"MADRID\",\n \"cnae\": \"6201\",\n \"cnae_label\": \"Actividades de programación informática\",\n \"financials\": {\n \"size_band\": \"GT_1M\",\n \"size_band_label\": \"Más de 1 M€\",\n \"last_accounts_year\": 2023\n },\n \"identifiers\": {\n \"lei\": \"5493000EJEMPLO000000\",\n \"lei_status\": \"ISSUED\",\n \"lei_next_renewal_date\": \"2027-03-15\",\n \"lei_source\": \"gleif\",\n \"lei_as_of\": \"2026-10-15\"\n },\n \"legal_form\": {\n \"code\": \"SL\",\n \"label\": \"Sociedad limitada\",\n \"iso20275\": \"DP3Q\",\n \"source\": \"name\"\n },\n \"group\": {\n \"direct_parent\": {\n \"lei\": \"5493000MATRIZ0000000\",\n \"name\": \"GRUPO EJEMPLO SA\",\n \"country\": \"ES\",\n \"cif\": \"A12345674\"\n },\n \"ultimate_parent\": {\n \"lei\": \"5493000MATRIZ0000000\",\n \"name\": \"GRUPO EJEMPLO SA\",\n \"country\": \"ES\",\n \"cif\": \"A12345674\"\n },\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"ownership\": {\n \"unipersonal\": true,\n \"sole_shareholder\": {\n \"name\": \"GRUPO EJEMPLO SA\",\n \"type\": \"company\",\n \"since\": \"2021-06-14\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf\"\n },\n \"source\": \"borme\",\n \"as_of\": \"2021-06-14\"\n },\n \"size\": {\n \"employees_min\": 10,\n \"employees_max\": 49,\n \"label\": \"De 10 a 49 empleados\",\n \"category\": \"small\",\n \"source\": \"kit_digital\",\n \"as_of\": \"2024-05-14\"\n },\n \"address_density\": {\n \"active_companies_at_address\": 63,\n \"level\": \"mass\",\n \"match\": \"exact_address\",\n \"as_of\": \"2026-10-19\"\n },\n \"sources\": {\n \"registry\": {\n \"source\": \"borme\",\n \"as_of\": \"2026-09-22\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2026/09/22/pdfs/BORME-A-2026-180-28.pdf\",\n \"fields\": [\n \"name\",\n \"founded\",\n \"corporate_purpose\"\n ]\n },\n \"status\": {\n \"source\": \"registry\",\n \"as_of\": \"2011-02-03\"\n },\n \"identifiers\": {\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"legal_form\": {\n \"source\": \"name\",\n \"as_of\": null\n },\n \"group\": {\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"ownership\": {\n \"source\": \"borme\",\n \"as_of\": \"2021-06-14\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf\"\n },\n \"size\": {\n \"source\": \"kit_digital\",\n \"as_of\": \"2024-05-14\"\n },\n \"address_density\": {\n \"source\": \"apiempresas\",\n \"as_of\": \"2026-10-19\"\n },\n \"administrators\": {\n \"source\": \"borme\",\n \"as_of\": \"2026-09-22\"\n }\n },\n \"administrators\": [\n {\n \"name\": \"JUAN PÉREZ GARCÍA\",\n \"position\": \"Adm. Unico\",\n \"since\": \"2019-03-01\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2019/03/01/pdfs/BORME-A-2019-42-28.pdf\"\n }\n ]\n }\n}" } ] } ] }, { "name": "2. Plan Pro", "item": [ { "name": "Consulta por CIF con administradores", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies?cif=A46103834&admin=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies" ], "query": [ { "key": "cif", "value": "A46103834" }, { "key": "admin", "value": "true" } ] }, "description": "Datos completos, financials (tramo de facturación y último año de cuentas) y administradores vigentes con su fecha de nombramiento. Coste: 1 consulta (1 crédito con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies?cif=A46103834&admin=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies" ], "query": [ { "key": "cif", "value": "A46103834" }, { "key": "admin", "value": "true" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"B12345678\",\n \"name\": \"EMPRESA DE EJEMPLO SL\",\n \"status\": \"ACTIVA\",\n \"status_code\": \"ACTIVE\",\n \"status_source\": \"registry\",\n \"status_date\": \"2011-02-03\",\n \"tax_id_revocation\": null,\n \"province\": \"MADRID\",\n \"cnae\": \"6201\",\n \"cnae_label\": \"Actividades de programación informática\",\n \"financials\": {\n \"size_band\": \"GT_1M\",\n \"size_band_label\": \"Más de 1 M€\",\n \"last_accounts_year\": 2023\n },\n \"identifiers\": {\n \"lei\": \"5493000EJEMPLO000000\",\n \"lei_status\": \"ISSUED\",\n \"lei_next_renewal_date\": \"2027-03-15\",\n \"lei_source\": \"gleif\",\n \"lei_as_of\": \"2026-10-15\"\n },\n \"legal_form\": {\n \"code\": \"SL\",\n \"label\": \"Sociedad limitada\",\n \"iso20275\": \"DP3Q\",\n \"source\": \"name\"\n },\n \"group\": {\n \"direct_parent\": {\n \"lei\": \"5493000MATRIZ0000000\",\n \"name\": \"GRUPO EJEMPLO SA\",\n \"country\": \"ES\",\n \"cif\": \"A12345674\"\n },\n \"ultimate_parent\": {\n \"lei\": \"5493000MATRIZ0000000\",\n \"name\": \"GRUPO EJEMPLO SA\",\n \"country\": \"ES\",\n \"cif\": \"A12345674\"\n },\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"ownership\": {\n \"unipersonal\": true,\n \"sole_shareholder\": {\n \"name\": \"GRUPO EJEMPLO SA\",\n \"type\": \"company\",\n \"since\": \"2021-06-14\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf\"\n },\n \"source\": \"borme\",\n \"as_of\": \"2021-06-14\"\n },\n \"size\": {\n \"employees_min\": 10,\n \"employees_max\": 49,\n \"label\": \"De 10 a 49 empleados\",\n \"category\": \"small\",\n \"source\": \"kit_digital\",\n \"as_of\": \"2024-05-14\"\n },\n \"address_density\": {\n \"active_companies_at_address\": 63,\n \"level\": \"mass\",\n \"match\": \"exact_address\",\n \"as_of\": \"2026-10-19\"\n },\n \"sources\": {\n \"registry\": {\n \"source\": \"borme\",\n \"as_of\": \"2026-09-22\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2026/09/22/pdfs/BORME-A-2026-180-28.pdf\",\n \"fields\": [\n \"name\",\n \"founded\",\n \"corporate_purpose\"\n ]\n },\n \"status\": {\n \"source\": \"registry\",\n \"as_of\": \"2011-02-03\"\n },\n \"identifiers\": {\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"legal_form\": {\n \"source\": \"name\",\n \"as_of\": null\n },\n \"group\": {\n \"source\": \"gleif\",\n \"as_of\": \"2026-10-15\"\n },\n \"ownership\": {\n \"source\": \"borme\",\n \"as_of\": \"2021-06-14\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf\"\n },\n \"size\": {\n \"source\": \"kit_digital\",\n \"as_of\": \"2024-05-14\"\n },\n \"address_density\": {\n \"source\": \"apiempresas\",\n \"as_of\": \"2026-10-19\"\n },\n \"administrators\": {\n \"source\": \"borme\",\n \"as_of\": \"2026-09-22\"\n }\n },\n \"administrators\": [\n {\n \"name\": \"JUAN PÉREZ GARCÍA\",\n \"position\": \"Adm. Unico\",\n \"since\": \"2019-03-01\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2019/03/01/pdfs/BORME-A-2019-42-28.pdf\"\n }\n ]\n }\n}" } ] }, { "name": "Verificación KYB", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/verify?cif=A46103834&name=Mercadona, S.A.&person=Juan Roig Alfonso&vat=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "verify" ], "query": [ { "key": "cif", "value": "A46103834" }, { "key": "name", "value": "Mercadona, S.A." }, { "key": "person", "value": "Juan Roig Alfonso" }, { "key": "vat", "value": "true" } ] }, "description": "Estado, nombre, firmante (administrador vigente) y NIF en VIES, con decision_hint pass/review/fail. En Business añade el nivel de riesgo. Coste: 2 consultas." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/verify?cif=A46103834&name=Mercadona, S.A.&person=Juan Roig Alfonso&vat=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "verify" ], "query": [ { "key": "cif", "value": "A46103834" }, { "key": "name", "value": "Mercadona, S.A." }, { "key": "person", "value": "Juan Roig Alfonso" }, { "key": "vat", "value": "true" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"B12345678\",\n \"exists\": true,\n \"name\": \"EMPRESA DE EJEMPLO SL\",\n \"status\": \"ACTIVA\",\n \"status_code\": \"ACTIVE\",\n \"status_source\": \"registry\",\n \"status_date\": null,\n \"tax_id_revocation\": null,\n \"identifiers\": {\n \"lei\": null,\n \"lei_status\": null,\n \"lei_next_renewal_date\": null,\n \"lei_source\": null,\n \"lei_as_of\": null\n },\n \"legal_form\": {\n \"code\": \"SL\",\n \"label\": \"Sociedad limitada\",\n \"iso20275\": \"DP3Q\",\n \"source\": \"name\"\n },\n \"group\": null,\n \"ownership\": {\n \"unipersonal\": true,\n \"sole_shareholder\": {\n \"name\": \"PEREZ GARCIA JUAN\",\n \"type\": \"person\",\n \"since\": \"2019-03-01\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2019/03/01/pdfs/BORME-A-2019-42-28.pdf\"\n },\n \"source\": \"borme\",\n \"as_of\": \"2019-03-01\"\n },\n \"size\": {\n \"employees_min\": 3,\n \"employees_max\": 9,\n \"label\": \"De 3 a 9 empleados\",\n \"category\": \"micro\",\n \"source\": \"kit_digital\",\n \"as_of\": \"2023-03-15\"\n },\n \"address_density\": {\n \"active_companies_at_address\": 1,\n \"level\": \"normal\",\n \"match\": \"exact_address\",\n \"as_of\": \"2026-10-19\"\n },\n \"checks\": {\n \"name\": {\n \"provided\": \"Empresa de Ejemplo, S.L.\",\n \"score\": 100,\n \"match\": true\n },\n \"person\": {\n \"provided\": \"Juan Pérez García\",\n \"is_current_admin\": true,\n \"matched_name\": \"PEREZ GARCIA JUAN\",\n \"position\": \"Adm. Unico\",\n \"since\": \"2019-03-01\",\n \"is_sole_shareholder\": true\n },\n \"vat\": {\n \"vat_number\": \"ESB12345678\",\n \"checked\": true,\n \"valid\": true,\n \"source\": \"VIES\",\n \"error\": null\n },\n \"eori\": {\n \"eori_number\": \"ESB12345678\",\n \"checked\": true,\n \"valid\": true,\n \"name\": null,\n \"address\": null,\n \"source\": \"EOS\",\n \"error\": null\n },\n \"iban\": {\n \"provided\": \"ES91****************1332\",\n \"valid\": true,\n \"country\": \"ES\",\n \"sepa\": true,\n \"bank_code\": \"2100\",\n \"branch_code\": \"0418\",\n \"reason\": null\n },\n \"accounts\": {\n \"last_accounts_year\": 2023\n }\n },\n \"flags\": [],\n \"decision_hint\": \"pass\",\n \"checked_at\": \"2026-09-28T10:30:00+02:00\"\n }\n}" } ] }, { "name": "Nombre a CIF (reconciliación)", "request": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"name\": \"Mercadona, S.A.\",\n \"province\": \"Valencia\"\n },\n {\n \"name\": \"Telefónica de España\"\n },\n {\n \"name\": \"Talleres Pérez\"\n }\n ]\n}" }, "url": { "raw": "{{BASE_URL}}/companies/reconcile", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "reconcile" ] }, "description": "Hasta 100 nombres por petición, con provincia opcional. Devuelve match (con CIF), ambiguous (hasta 3 candidatos) o no_match. 1 consulta por cada match; el resto no se cobra." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"name\": \"Mercadona, S.A.\",\n \"province\": \"Valencia\"\n },\n {\n \"name\": \"Telefónica de España\"\n },\n {\n \"name\": \"Talleres Pérez\"\n }\n ]\n}" }, "url": { "raw": "{{BASE_URL}}/companies/reconcile", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "reconcile" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"input\": {\n \"name\": \"Mercadona, S.A.\",\n \"province\": \"Valencia\"\n },\n \"status\": \"match\",\n \"score\": 100,\n \"company\": {\n \"cif\": \"A46103834\",\n \"name\": \"MERCADONA SA\",\n \"province\": \"VALENCIA\",\n \"status\": \"ACTIVA\",\n \"status_code\": \"ACTIVE\",\n \"score\": 100\n }\n },\n {\n \"input\": {\n \"name\": \"Talleres Pérez\",\n \"province\": null\n },\n \"status\": \"ambiguous\",\n \"candidates\": [\n {\n \"cif\": \"B12345678\",\n \"name\": \"TALLERES PEREZ SL\",\n \"province\": \"MADRID\",\n \"status\": \"ACTIVA\",\n \"status_code\": \"ACTIVE\",\n \"score\": 100\n },\n {\n \"cif\": \"A12345674\",\n \"name\": \"TALLERES PEREZ SA\",\n \"province\": \"SEVILLA\",\n \"status\": \"ACTIVA\",\n \"status_code\": \"ACTIVE\",\n \"score\": 100\n }\n ]\n },\n {\n \"input\": {\n \"name\": \"Panadería Inventada del Norte\",\n \"province\": null\n },\n \"status\": \"no_match\"\n }\n ],\n \"meta\": {\n \"requested\": 3,\n \"matched\": 1,\n \"ambiguous\": 1,\n \"no_match\": 1,\n \"invalid\": 0,\n \"skipped_quota\": 0,\n \"cost\": 1,\n \"thresholds\": {\n \"match\": 85,\n \"ambiguous\": 70\n }\n }\n}" } ] }, { "name": "Validar NIF para facturar (lote)", "request": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"cif\": \"A46103834\",\n \"name\": \"Mercadona\",\n \"ref\": \"cli-001\"\n },\n {\n \"cif\": \"A15075062\",\n \"name\": \"Inditex\",\n \"ref\": \"cli-002\"\n },\n {\n \"cif\": \"A46103835\",\n \"ref\": \"cli-003\"\n },\n {\n \"cif\": \"12345678Z\",\n \"ref\": \"cli-004\"\n }\n ]\n}" }, "url": { "raw": "{{BASE_URL}}/companies/verify/batch", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "verify", "batch" ] }, "description": "Hasta 1.000 NIF por petición, con la razón social guardada (name) y tu identificador (ref) opcionales. Devuelve formato válido, si consta, razón social y domicilio oficiales, estado y invoice_hint (ok, revisar, no_facturar). 1 consulta por sociedad encontrada; lo inválido y lo que no consta no se cobra." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"cif\": \"A46103834\",\n \"name\": \"Mercadona\",\n \"ref\": \"cli-001\"\n },\n {\n \"cif\": \"A15075062\",\n \"name\": \"Inditex\",\n \"ref\": \"cli-002\"\n },\n {\n \"cif\": \"A46103835\",\n \"ref\": \"cli-003\"\n },\n {\n \"cif\": \"12345678Z\",\n \"ref\": \"cli-004\"\n }\n ]\n}" }, "url": { "raw": "{{BASE_URL}}/companies/verify/batch", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "verify", "batch" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"input\": \"A46103834\",\n \"cif\": \"A46103834\",\n \"ref\": \"cli-001\",\n \"valid_format\": true,\n \"processed\": true,\n \"exists\": true,\n \"legal_name\": \"MERCADONA SA\",\n \"address\": {\n \"street\": \"CALLE VALENCIA 5\",\n \"postal_code\": \"46016\",\n \"municipality\": \"TAVERNES BLANQUES\",\n \"province\": \"VALENCIA\"\n },\n \"status_code\": \"ACTIVE\",\n \"status_date\": null,\n \"tax_id_revocation\": null,\n \"name_check\": {\n \"provided\": \"Mercadona\",\n \"score\": 100,\n \"match\": true\n },\n \"invoice_hint\": \"ok\",\n \"flags\": []\n },\n {\n \"input\": \"A15075062\",\n \"cif\": \"A15075062\",\n \"ref\": \"cli-002\",\n \"valid_format\": true,\n \"processed\": true,\n \"exists\": true,\n \"legal_name\": \"INDUSTRIA DE DISENO TEXTIL SA\",\n \"address\": {\n \"street\": \"AVENIDA DE LA DIPUTACION (ED INDITEX), S/N\",\n \"postal_code\": \"15142\",\n \"municipality\": \"ARTEIXO\",\n \"province\": \"A CORUÑA\"\n },\n \"status_code\": \"ACTIVE\",\n \"status_date\": null,\n \"tax_id_revocation\": null,\n \"name_check\": {\n \"provided\": \"Inditex\",\n \"score\": 42,\n \"match\": false\n },\n \"invoice_hint\": \"revisar\",\n \"flags\": [\n {\n \"code\": \"NAME_MISMATCH\",\n \"severity\": \"high\",\n \"message\": \"El nombre que tienes guardado no coincide con la razón social: usa legal_name en la factura.\"\n }\n ]\n },\n {\n \"input\": \"A46103835\",\n \"cif\": \"A46103835\",\n \"ref\": \"cli-003\",\n \"valid_format\": false,\n \"processed\": true,\n \"exists\": null,\n \"invoice_hint\": \"no_facturar\",\n \"flags\": [\n {\n \"code\": \"INVALID_FORMAT\",\n \"severity\": \"high\",\n \"message\": \"El NIF no tiene un formato válido (dígito o letra de control incorrectos).\"\n }\n ]\n },\n {\n \"input\": \"12345678Z\",\n \"cif\": \"12345678Z\",\n \"ref\": \"cli-004\",\n \"valid_format\": true,\n \"processed\": true,\n \"exists\": null,\n \"invoice_hint\": \"revisar\",\n \"flags\": [\n {\n \"code\": \"PERSON_NIF\",\n \"severity\": \"info\",\n \"message\": \"NIF de persona física (autónomo o particular): la letra de control es correcta, pero no damos datos de personas (RGPD).\"\n }\n ]\n }\n ],\n \"meta\": {\n \"requested\": 4,\n \"found\": 2,\n \"cost\": 2,\n \"truncated\": false,\n \"summary\": {\n \"ok\": 1,\n \"revisar\": 2,\n \"no_facturar\": 1,\n \"not_processed\": 0\n },\n \"checked_at\": \"2026-10-25T10:00:00+02:00\",\n \"note\": \"No sustituye la comprobación contra el censo de la AEAT. Razón social y domicilio según el Registro Mercantil y el BORME.\"\n }\n}" } ] }, { "name": "Consulta Múltiples Empresas (Batch)", "request": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/batch", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "batch" ] }, "body": { "mode": "raw", "raw": "{\n \"cifs\": [\n \"A15075062\",\n \"A46103834\"\n ],\n \"admin\": true\n}" }, "description": "Hasta 100 CIF. Se cobra una consulta por empresa encontrada." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/batch", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "batch" ] }, "body": { "mode": "raw", "raw": "{\n \"cifs\": [\n \"A15075062\",\n \"A46103834\"\n ],\n \"admin\": true\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"cif\": \"B12345678\",\n \"name\": \"EMPRESA DE EJEMPLO SL\",\n \"status\": \"ACTIVA\"\n },\n {\n \"cif\": \"A87654321\",\n \"name\": \"OTRA EMPRESA SA\",\n \"status\": \"ACTIVA\"\n }\n ],\n \"meta\": {\n \"requested\": 3,\n \"found\": 2,\n \"cost\": 2,\n \"truncated\": false\n }\n}" } ] }, { "name": "Scoring Comercial", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/score?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "score" ], "query": [ { "key": "cif", "value": "A15075062" } ] }, "description": "Puntuación comercial (0-100) con prioridad (muy_alta…muy_baja), motivos y última señal del BORME. En Free solo la cifra, sin gastar consultas (máximo 25 vistas previas al día). Coste: 1 consulta del plan (3 créditos con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/score?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "score" ], "query": [ { "key": "cif", "value": "A15075062" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"B12345678\",\n \"score\": 82,\n \"priority\": \"muy_alta\",\n \"reasons\": [\n \"OPP:95|QUAL:80|CONT:60 · Ampliación de capital\"\n ],\n \"last_signal\": {\n \"type\": \"Ampliación de capital\",\n \"date\": \"2026-09-15\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2026/09/15/pdfs/BORME-A-2026-176-15.pdf\"\n },\n \"source\": \"radar\"\n }\n}" } ] }, { "name": "Señales Societarias", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/signals?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "signals" ], "query": [ { "key": "cif", "value": "A15075062" } ] }, "description": "Último acto del BORME que cuenta para la puntuación (como mucho un elemento). probability es la prioridad comercial, no la fiabilidad del evento. 404 si la empresa no existe. Coste: 1 consulta del plan (3 créditos con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/signals?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "signals" ], "query": [ { "key": "cif", "value": "A15075062" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"A46103834\",\n \"signals\": [\n {\n \"type\": \"borme_event\",\n \"label\": \"Ampliación de capital\",\n \"date\": \"2026-09-15\",\n \"probability\": \"muy_alta\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2026/09/15/pdfs/BORME-A-2026-176-15.pdf\"\n }\n ]\n }\n}" } ] }, { "name": "Historial Actos BORME", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/borme?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "borme" ], "query": [ { "key": "cif", "value": "A15075062" } ] }, "description": "Historial de actos publicados en el BORME. Pro, Business y Free con bono. Coste: 1 consulta del plan (3 créditos con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/borme?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "borme" ], "query": [ { "key": "cif", "value": "A15075062" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"B12345678\",\n \"company_name\": \"EMPRESA DE EJEMPLO SL\",\n \"events\": [\n {\n \"date\": \"2023-11-01\",\n \"act_types\": \"Nombramientos, Ceses\",\n \"description\": \"Ceses/Dimisiones. Administrador único: JUAN PEREZ...\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2023/11/01/pdfs/BORME-A-2023-100-28.pdf\"\n }\n ]\n }\n}" } ] }, { "name": "Grafos de Poder Societario", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/network?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "network" ], "query": [ { "key": "cif", "value": "A15075062" } ] }, "description": "Red de empresas vinculadas a través de sus administradores. Pro, Business y Free con bono. Coste: 1 consulta del plan (3 créditos con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/network?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "network" ], "query": [ { "key": "cif", "value": "A15075062" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"nodes\": [\n {\n \"id\": \"C_123\",\n \"type\": \"company\",\n \"label\": \"EMPRESA DE EJEMPLO SL\",\n \"cif\": \"B12345678\",\n \"root\": true\n },\n {\n \"id\": \"A_abc\",\n \"type\": \"administrator\",\n \"label\": \"JUAN PEREZ GARCIA\"\n }\n ],\n \"edges\": [\n {\n \"source\": \"A_abc\",\n \"target\": \"C_123\",\n \"label\": \"Administrador\"\n }\n ],\n \"stats\": {\n \"total_administrators\": 1,\n \"total_linked_companies\": 1\n }\n }\n}" } ] }, { "name": "Radar con filtros", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/radar?range=30&province=MADRID&cnae=62&has_phone=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "radar" ], "query": [ { "key": "range", "value": "30" }, { "key": "province", "value": "MADRID" }, { "key": "cnae", "value": "62" }, { "key": "has_phone", "value": "true" } ] }, "description": "Hasta 100 resultados en Pro y 1.000 en Business. Filtros opcionales: province, cnae (prefijos separados por comas), min_score, priority, main_act_type, has_phone. Coste: 1 consulta del plan (3 créditos con bono)." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/radar?range=30&province=MADRID&cnae=62&has_phone=true", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "radar" ], "query": [ { "key": "range", "value": "30" }, { "key": "province", "value": "MADRID" }, { "key": "cnae", "value": "62" }, { "key": "has_phone", "value": "true" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"meta\": {\n \"plan\": \"business\",\n \"count\": 50,\n \"limit\": 1000,\n \"total_disponibles\": 50\n },\n \"data\": [\n {\n \"id\": 4812345,\n \"company_name\": \"NUEVA EMPRESA SL\",\n \"cif\": \"B12345678\",\n \"fecha_constitucion\": \"2026-10-13\",\n \"cnae\": \"6201\",\n \"cnae_label\": \"Actividades de programación informática\",\n \"registro_mercantil\": \"MADRID\",\n \"municipality\": \"MADRID\",\n \"score_total\": 78,\n \"priority_level\": \"alta\",\n \"main_act_type\": \"Constitución\"\n }\n ]\n}" } ] }, { "name": "Insights IA (vista previa)", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/insights?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "insights" ], "query": [ { "key": "cif", "value": "A15075062" } ] }, "description": "En Pro, perfil y probabilidad de conversión. El análisis completo va en Business. No gasta consultas (máximo 25 vistas previas al día), pero hace falta que te quede alguna." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/companies/insights?cif=A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "companies", "insights" ], "query": [ { "key": "cif", "value": "A15075062" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"profile\": \"Servicios de Tecnología\",\n \"summary\": \"Empresa enfocada en desarrollo software...\",\n \"needs\": [\n \"Presencia Web\",\n \"Gestión Cloud\"\n ],\n \"conversion_probability\": \"Alta\",\n \"estimated_ticket\": \"Medio-Alto\"\n }\n}" } ] }, { "name": "Vigilancia: añadir empresas", "request": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist" ] }, "body": { "mode": "raw", "raw": "{\n \"cifs\": [\n \"A15075062\",\n \"A46103834\"\n ]\n}" }, "description": "Hasta 500 CIF por petición. Pro: 100 empresas en total; Business: 1.000. No gasta consultas." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "POST", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist" ] }, "body": { "mode": "raw", "raw": "{\n \"cifs\": [\n \"A15075062\",\n \"A46103834\"\n ]\n}" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"added\": [\n \"A46103834\"\n ],\n \"already_watching\": [\n \"A15075062\"\n ],\n \"not_found\": [],\n \"invalid\": [],\n \"rejected_over_limit\": []\n },\n \"meta\": {\n \"total\": 2,\n \"watch_limit\": 100\n }\n}" } ] }, { "name": "Vigilancia: listar empresas", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist?page=1&limit=100", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist" ], "query": [ { "key": "page", "value": "1" }, { "key": "limit", "value": "100" } ] }, "description": "No gasta consultas." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist?page=1&limit=100", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist" ], "query": [ { "key": "page", "value": "1" }, { "key": "limit", "value": "100" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"cif\": \"A46103834\",\n \"name\": \"MERCADONA SA\",\n \"added_at\": \"2026-09-27 10:12:04\"\n },\n {\n \"cif\": \"A15075062\",\n \"name\": \"INDUSTRIA DE DISENO TEXTIL SA\",\n \"added_at\": \"2026-09-28 08:30:51\"\n }\n ],\n \"meta\": {\n \"total\": 2,\n \"watch_limit\": 100,\n \"page\": 1,\n \"limit\": 100,\n \"has_more\": false\n }\n}" } ] }, { "name": "Vigilancia: eventos", "request": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist/events?since=2026-09-01&types=borme_act,status_change,risk_level_change", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist", "events" ], "query": [ { "key": "since", "value": "2026-09-01" }, { "key": "types", "value": "borme_act,status_change,risk_level_change" } ] }, "description": "Cambios desde una fecha (máximo 90 días atrás), de más antiguo a más reciente. No gasta consultas." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "GET", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist/events?since=2026-09-01&types=borme_act,status_change,risk_level_change", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist", "events" ], "query": [ { "key": "since", "value": "2026-09-01" }, { "key": "types", "value": "borme_act,status_change,risk_level_change" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"borme_act:8812345\",\n \"type\": \"borme_act\",\n \"date\": \"2026-09-22\",\n \"cif\": \"B12345678\",\n \"company_name\": \"EMPRESA DE EJEMPLO SL\",\n \"data\": {\n \"act_types\": \"Nombramientos, Ceses/Dimisiones\",\n \"description\": \"Ceses/Dimisiones. Adm. Unico: ...\",\n \"url_pdf\": \"https://www.boe.es/borme/dias/2026/09/22/pdfs/BORME-A-2026-181-28.pdf\"\n }\n },\n {\n \"id\": \"risk_level_change:B12345678:2026-09-25\",\n \"type\": \"risk_level_change\",\n \"date\": \"2026-09-25\",\n \"cif\": \"B12345678\",\n \"company_name\": \"EMPRESA DE EJEMPLO SL\",\n \"data\": {\n \"from\": \"BAJO\",\n \"to\": \"MEDIO\",\n \"model_change\": null\n }\n }\n ],\n \"meta\": {\n \"since\": \"2026-09-20\",\n \"types\": [\n \"borme_act\",\n \"status_change\",\n \"risk_level_change\",\n \"insolvency\"\n ],\n \"total\": 2,\n \"page\": 1,\n \"limit\": 100,\n \"has_more\": false\n }\n}" } ] }, { "name": "Vigilancia: quitar empresa", "request": { "method": "DELETE", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist/A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist", "A15075062" ] }, "description": "404 NOT_WATCHING si no estaba en tu vigilancia. No gasta consultas." }, "response": [ { "name": "Ejemplo 200", "originalRequest": { "method": "DELETE", "header": [ { "key": "X-API-KEY", "value": "{{API_KEY}}", "type": "text" }, { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{BASE_URL}}/watchlist/A15075062", "host": [ "{{BASE_URL}}" ], "path": [ "watchlist", "A15075062" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"cif\": \"A46103834\",\n \"removed\": true\n },\n \"meta\": {\n \"total\": 1,\n \"watch_limit\": 100\n }\n}" } ] } ] } ], "variable": [ { "key": "API_KEY", "value": "tu_api_key_aqui", "type": "string" }, { "key": "BASE_URL", "value": "https://apiempresas.es/api/v1", "type": "string", "description": "Producción. Para probar sin gastar consultas: https://apiempresas.es/api/sandbox/v1 (solo CIF A15075062 y B00000000)." }, { "key": "WEBHOOK_ID", "value": "123", "type": "string", "description": "id de uno de tus webhooks (lo devuelve Crear Webhook)." } ] }