{
  "info": {
    "_postman_id": "8c5e2a1b-7d3a-4f5a-9e2c-1b2a3d4f5a01",
    "name": "APIEmpresas.es - Plan Free",
    "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}"
            }
          ]
        }
      ]
    }
  ],
  "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)."
    }
  ]
}