[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-page:spanish-company-tax-data":3},{"status":4,"api":5,"seo":190},"success",{"blocked":6,"description":7,"about":8,"stats":9,"name":11,"title":12,"slug":13,"logo":14,"created_at":15,"agent":16,"user":28,"endpoint_groups":31,"faqs":155,"features":165,"periodic_plans":166,"payasyougo_plans":167,"releases":187,"last_updated":188,"createdAtText":189},false,"Extract a Spanish company CIF/NIF and legal name from its website. Checks the NIF control character and legal-page context, with a source path for CRM enrichment and supplier onboarding.","# Spanish Company CIF NIF Lookup from Website\n\n## Start with a website. Get a company identity you can inspect.\n\nThis API turns a Spanish company website into structured legal-company data: corporate CIF/NIF, legal name, source page and an explicitly stated fiscal address when available. Built for CRM enrichment, supplier onboarding and company-data workflows.\n\n### When to use this API\n\n- Start with a URL, even when you do not know the company NIF.\n- Spanish corporate NIF structure and check-character validation, combined with a contextual legal-name match.\n- Inspect the original legal/contact page through `found_at`. Conflicting identities return an explicit error.\n- One JSON request and response. Pay per lookup without a monthly base subscription.\n\n### Request\n\nSend `POST /v1/extract` with `Content-Type: application/json`, your marketplace API key and this body:\n\n```json\n{\"url\":\"https://www.futuroinformatica.com/\"}\n```\n\nResponses include `success`, `domain`, `legal_name`, `tax_id`, `tax_id_valid`, `tax_address` and `found_at`. A fiscal address is returned only when explicitly labelled and attributable to the company.\n\n### Scope and billing\n\nPublic static HTML only. Personal DNI/NIE, browser-rendered pages and PDFs are excluded. Corporate NIF checksum validation does not confirm registration with AEAT or VIES, domain ownership or current tax status. Missing or ambiguous data is returned explicitly instead of guessing.\n\nThe public plan costs $0.01 per processed lookup, including negative and ambiguous results, with 10 requests per minute. Marketplace fees and gateway/server-error billing rules apply. The extraction work budget is five seconds; network and gateway overhead are additional.\n\n### Use with AI agents through MCP\n\nConnect an HTTP-compatible MCP client to `https://mcp.jojapi.com/spanish-company-tax-data`. Set `Authorization: Bearer YOUR_JOJ_API_KEY` as a connection header and use the listing's current plan. The documented extraction endpoint becomes a tool that accepts a company website URL.\n\nThe MCP tool wraps the HTTP JSON payload inside `body`. Supply tool arguments such as:\n\n```json\n{\"body\":{\"url\":\"https://www.futuroinformatica.com/\"}}\n```\n\nFor a direct HTTP request, send only the inner `{\"url\":\"...\"}` object as the request body. The URL is required in both cases.\n\nFor an agent workflow, supply a public Spanish company website, check `success`, retain `found_at` as evidence, and review ambiguous or missing results instead of inferring a tax ID. Use the **OpenAPI spec** and **MCP server** links on the listing for the current schema. Tool execution uses the same gateway and billing rules as ordinary API calls.\n\n### Typical workflows\n\n- Add the published corporate tax ID and legal name to a CRM record that already has a website.\n- Prepare a supplier record for human review with the source page attached.\n- Match a company domain to the identity stated on its legal notice page.\n\nExtraction and check-character validation are separate from official company or tax registration verification.",{"score":10},"2.63","Spanish Company CIF NIF Lookup from Website","Spanish Company CIF NIF Lookup from Website API","spanish-company-tax-data","https://cdn.jojapi.com/api/7e57f89c-7452-4be3-bfbe-ac4ce8375985","2026-10-16 16:40:24",{"enabled":17,"closed":18,"request_enabled":6,"catalog_url":19,"discovery_url":20,"directory_url":21,"rails":22,"networks":25,"docs":27},true,null,"https://tdrgc.jojapi.net/_jojapi/agent/plans","https://tdrgc.jojapi.net/.well-known/x402","https://agents.jojapi.net/apis/spanish-company-tax-data",[23,24],"x402","mpp",[26],"eip155:8453","https://docs.jojapi.com/consumers/agents",{"nick":29,"name":30,"verified":6,"website":18},"dekaz","Dekaz",[32],{"endpoints":33,"name":154,"description":61,"ungrouped":6},[34],{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":35,"description":42,"method":43,"name":44,"url_path":45,"root_url":46,"parameters":47,"responses":64,"result_stats":150},[36],{"name":37,"slug":38,"cost":39,"label":40,"avg":41},"Company lookups","company-lookups","1","One website lookup, including completed negative or ambiguous results.",1,"Checks the homepage and same-site legal/contact pages. Accepts one URL per request. Supports implemented Spanish limited company, public limited company and cooperative forms; does not execute JavaScript or read PDFs/images. A completed lookup without a match can consume a billable query. Gateway authentication and subscription errors may use the marketplace response format.","POST","Extract a Spanish company identity from a website","/v1/extract","https://tdrgc.jojapi.net",{"url":48,"header":49,"post":56,"body":57,"path":63},[],[50],{"key":51,"is_auth":17,"example":52,"example_disabled":17,"example_type":53,"name":54,"description":52,"required":17,"always_error":55},"X-JoJAPI-Key","You must log in to get API key","string","JoJ API Key","Please log in to get API key",[],[58],{"key":18,"example":59,"schema":60,"example_disabled":6,"example_type":53,"value_type":53,"enum_values":18,"default_value":61,"required":6,"name":18,"description":62},"{\"url\":\"https:\\/\\/comercial-horizonte.es\"}","{\"type\":\"object\",\"additionalProperties\":false,\"required\":[\"url\"],\"properties\":{\"url\":{\"type\":\"string\",\"minLength\":4,\"maxLength\":1024,\"x-max-utf16-code-units\":1024,\"example\":\"https:\\/\\/example.com\\/\",\"description\":\"Public website hostname or HTTP\\/HTTPS URL. Normalized to the HTTPS origin. Paths and queries are discarded. Credentials, IP literals, private destinations, fragments and non-standard ports are rejected.\"}}}","","''",[],[65,74,80,85,90,95,100,105,110,115,120,125,130,135,140,145],{"status":66,"status_code":67,"description":68,"schema":69,"examples":70,"example":73},"200",200,"A unique company identity was associated and its tax identifier passed formal validation. The example is fictional.","{\"type\":\"object\",\"additionalProperties\":false,\"required\":[\"success\",\"domain\",\"legal_name\",\"tax_id\",\"tax_id_valid\",\"tax_address\",\"found_at\"],\"properties\":{\"success\":{\"type\":\"boolean\",\"enum\":[true]},\"domain\":{\"type\":\"string\",\"example\":\"comercial-horizonte.es\",\"description\":\"Normalized hostname without a leading www. Other subdomains are preserved.\"},\"legal_name\":{\"type\":\"string\",\"minLength\":1,\"example\":\"Comercial Horizonte SL\",\"description\":\"Legal company name associated with the corporate tax identifier.\"},\"tax_id\":{\"type\":\"string\",\"pattern\":\"^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$\",\"minLength\":9,\"maxLength\":9,\"example\":\"B12345674\",\"description\":\"Spanish corporate tax identifier with a valid structure and check character. Personal DNI\\/NIE identifiers are excluded.\"},\"tax_id_valid\":{\"type\":\"boolean\",\"enum\":[true],\"description\":\"Formal validity only. This does not certify registration, existence, activity or website ownership.\"},\"tax_address\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Explicitly labelled and attributable fiscal address; null when missing or conflicting.\"},\"found_at\":{\"type\":\"string\",\"pattern\":\"^\\/\",\"example\":\"\\/aviso-legal\",\"description\":\"Source page path, without a query string.\"}}}",[71],{"name":72,"summary":61,"description":61,"example":73},"default","{\"success\":true,\"domain\":\"comercial-horizonte.es\",\"legal_name\":\"Comercial Horizonte SL\",\"tax_id\":\"B12345674\",\"tax_id_valid\":true,\"tax_address\":\"Calle Mayor 1, 28013 Madrid\",\"found_at\":\"\\/aviso-legal\"}",{"status":75,"status_code":76,"description":77,"schema":78,"examples":79,"example":61},"400",400,"Invalid JSON, input schema or public website URL.","{\"type\":\"object\",\"additionalProperties\":false,\"required\":[\"success\",\"domain\",\"legal_name\",\"tax_id\",\"tax_id_valid\",\"tax_address\",\"found_at\",\"error\"],\"properties\":{\"success\":{\"type\":\"boolean\",\"enum\":[false]},\"domain\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Normalized hostname if established; otherwise null.\"},\"legal_name\":{\"type\":\"string\",\"nullable\":true,\"enum\":[null]},\"tax_id\":{\"type\":\"string\",\"nullable\":true,\"enum\":[null]},\"tax_id_valid\":{\"type\":\"boolean\",\"enum\":[false]},\"tax_address\":{\"type\":\"string\",\"nullable\":true,\"enum\":[null]},\"found_at\":{\"type\":\"string\",\"nullable\":true,\"enum\":[null]},\"error\":{\"type\":\"object\",\"additionalProperties\":false,\"required\":[\"code\",\"message\"],\"properties\":{\"code\":{\"type\":\"string\",\"enum\":[\"invalid_url\",\"invalid_request\",\"request_too_large\",\"unsupported_media_type\",\"unauthorized\",\"not_configured\",\"not_found\",\"invalid_tax_id\",\"ambiguous\",\"upstream_unavailable\",\"timeout\",\"internal_error\",\"route_not_found\",\"method_not_allowed\"]},\"message\":{\"type\":\"string\",\"description\":\"Human-readable message returned by the origin, currently in Spanish. Use the HTTP status and code for client logic.\"}}}}}",[],{"status":81,"status_code":82,"description":83,"schema":78,"examples":84,"example":61},"401",401,"Authentication failed. Check your JoJ API key and subscription. Gateway errors can use a different body.",[],{"status":86,"status_code":87,"description":88,"schema":18,"examples":89,"example":61},"402",402,"Gateway billing rejection: insufficient balance, exhausted quota or a plan that does not cover this endpoint.",[],{"status":91,"status_code":92,"description":93,"schema":18,"examples":94,"example":61},"403",403,"Gateway access rejection: the consumer key is restricted or the account cannot access this API.",[],{"status":96,"status_code":97,"description":98,"schema":78,"examples":99,"example":61},"404",404,"No usable company identity was found. A completed lookup can consume a billable query.",[],{"status":101,"status_code":102,"description":103,"schema":78,"examples":104,"example":61},"405",405,"Method not allowed. This endpoint accepts POST.",[],{"status":106,"status_code":107,"description":108,"schema":78,"examples":109,"example":61},"409",409,"Conflicting company identities or an ambiguous association.",[],{"status":111,"status_code":112,"description":113,"schema":78,"examples":114,"example":61},"413",413,"The request body exceeds 2048 bytes or its declared length is invalid.",[],{"status":116,"status_code":117,"description":118,"schema":78,"examples":119,"example":61},"415",415,"Use Content-Type: application/json.",[],{"status":121,"status_code":122,"description":123,"schema":78,"examples":124,"example":61},"422",422,"An observed corporate tax identifier failed formal validation.",[],{"status":126,"status_code":127,"description":128,"schema":18,"examples":129,"example":61},"429",429,"A rate or quota limit was reached. Gateway errors can use a different body.",[],{"status":131,"status_code":132,"description":133,"schema":78,"examples":134,"example":61},"500",500,"Internal processing error; no internal details are exposed.",[],{"status":136,"status_code":137,"description":138,"schema":78,"examples":139,"example":61},"502",502,"No usable public source page could be downloaded.",[],{"status":141,"status_code":142,"description":143,"schema":78,"examples":144,"example":61},"503",503,"The origin service is not available for authenticated extraction.",[],{"status":146,"status_code":147,"description":148,"schema":78,"examples":149,"example":61},"504",504,"The application time budget was exhausted.",[],{"x2":151,"x3":152,"x4":152,"x5":152,"uptime":151,"avg_latency":153,"avg_credits":152},"100.00","0.00","2,022","Company data",[156,159,162],{"question":157,"answer":158},"Does tax_id_valid confirm registration with AEAT or VIES?","No. It confirms the implemented Spanish corporate NIF structure and control character, with a contextual company-name match in public website text. This is not an AEAT, VIES or business-registry lookup and does not prove current tax registration or domain ownership. Personal DNI/NIE identifiers are excluded.",{"question":160,"answer":161},"What happens when a website has no clear company identity?","The API returns a structured error and null identity fields instead of guessing: 404 for no usable match, 409 for ambiguous evidence and 422 for an invalid tax ID. Completed negative or ambiguous lookups consume one paid query. Server and gateway failures follow the marketplace billing policy. Only static public HTML is checked; JavaScript-rendered pages, PDFs and images are not supported. The extraction budget is five seconds, excluding gateway and network overhead.",{"question":163,"answer":164},"Can an AI agent enrich a company website with its Spanish CIF/NIF?","Yes. Connect an HTTP-compatible MCP client to https://mcp.jojapi.com/spanish-company-tax-data with Authorization: Bearer YOUR_JOJ_API_KEY as a connection header and choose the listing plan. Supply the company website URL to the extraction tool, check success, and retain found_at as source evidence. Missing or ambiguous identities require review. The result checks published website evidence and the corporate NIF control character; it is not an official tax-register verification. MCP calls follow the same billing rules as HTTP calls.",[],[],[168],{"type":169,"slug":170,"blocked":6,"period":171,"currency":172,"pricing":173,"rate_limit":174,"objects":177,"name":185,"display_name":185,"features":186},"payasyougo","ugr6n1dk3s4qgdxffxq4jg50","1 MONTH","usd",[],{"max_requests":175,"time_window":176},10,60,[178],{"id":179,"name":37,"slug":38,"quota":18,"tiers":180},"n4cb8d0da",[181],{"start":182,"unit_price":183,"start_text":184},0,0.01,"0","Pay per lookup",[],[],"2026-10-16 18:35:17","2026-10-16",{"canonical":191,"page_title":192,"meta":193},"https://jojapi.com/hub/api/spanish-company-tax-data","Spanish Company CIF NIF Lookup from Website API Documentation & Playground - JoJ API",{"description":7,"keywords":194},"API,API Documentation,API Playground,Plans & Pricing,Spanish Company CIF NIF Lookup from Website,dekaz"]