{"components":{"schemas":{"Address":{"description":"Company address","properties":{"address":{"description":"Address street information - full","type":"string"},"addressType":{"description":"Address type","type":"string"},"province":{"description":"Province","type":"string"},"streetContinued":{"description":"Address detail street extra information","type":"string"},"streetName":{"description":"Address detail street name","type":"string"},"streetNumber":{"description":"Address detail street number","type":"string"},"streetType":{"description":"Address detail street type","type":"string"},"town":{"description":"Town","type":"string"},"zipCode":{"description":"Zip code","type":"string"}},"type":"object"},"BadRequest":{"description":"Returned when something is wrong in the request, e.g. failed argument validation or missed argument","properties":{"attributes":{"description":"Invalid attributes","items":{"$ref":"#/components/schemas/RequestAttribute"},"type":"array"},"error":{"default":"BadRequest","description":"Error name","type":"string"},"message":{"default":"Required arguments are missing in the request","description":"Description of the request error","type":"string"}},"type":"object"},"BankruptcyStatus":{"properties":{"code":{"description":"Bankruptcy status code","type":"string"},"date":{"description":"Bankruptcy status date (Date in ISO 8601 standard)","type":"string"},"text":{"description":"Bankruptcy status description","type":"string"}},"type":"object"},"Contact":{"properties":{"phoneNumber":{"description":"Telephone number","type":"string"},"webAddress":{"description":"Web address","type":"string"}},"type":"object"},"Industry":{"description":"Industry","properties":{"code":{"description":"Company main industry, CNAE code","type":"string"},"text":{"description":"Company main industry, CNAE description","type":"string"}},"type":"object"},"LatestConfirmedActivityStatus":{"properties":{"code":{"description":"Latest Confirmed Activity Status Code","type":"string"},"date":{"description":"Date when the status was confirmed (ISO 8601 standard)","type":"string"},"text":{"description":"Latest Confirmed Activity status description","type":"string"}},"type":"object"},"LegalGroup":{"properties":{"code":{"description":"Company type code","type":"string"},"text":{"description":"Company type text","type":"string"}},"type":"object"},"Overview":{"description":"Company overview","properties":{"addresses":{"description":"Addresses","items":{"$ref":"#/components/schemas/Address"},"type":"array"},"bankruptcyStatus":{"$ref":"#/components/schemas/BankruptcyStatus"},"changeDate":{"description":"Date for the latest change (Date in ISO 8601 standard)","type":"string"},"companyDeregistrationDate":{"description":"Company deregistration date (Date in ISO 8601 standard)","type":"string"},"companyId":{"description":"National identifier for the company","type":"string"},"companyName":{"description":"Company name","type":"string"},"companyRegistrationDate":{"description":"Date of start of operations-incorporation date (Date in ISO 8601 standard)","type":"string"},"contact":{"$ref":"#/components/schemas/Contact"},"industry":{"$ref":"#/components/schemas/Industry"},"latestConfirmedActivityStatus":{"$ref":"#/components/schemas/LatestConfirmedActivityStatus"},"legalGroup":{"$ref":"#/components/schemas/LegalGroup"},"numberCompanyUnits":{"description":"Number of company units/workplaces","format":"int32","type":"integer"},"numberEmployees":{"description":"Number of employees","format":"int32","type":"integer"},"topDirector":{"$ref":"#/components/schemas/TopDirector"},"tradeName":{"description":"Trade name","type":"string"},"tradeStatus":{"$ref":"#/components/schemas/TradeStatus"}},"type":"object"},"OverviewsResult":{"description":"Company(s) overview(s) result","properties":{"records":{"description":"found overview(s)","items":{"$ref":"#/components/schemas/Overview"},"type":"array"},"status":{"$ref":"#/components/schemas/SearchResultStatus"}},"type":"object"},"RequestAttribute":{"description":"Incorrect attribute of request","properties":{"attribute":{"description":"Parameter name","type":"string"},"value":{"description":"Parameter value, subject for validation","type":"string"}},"type":"object"},"SearchResultStatus":{"description":"Description of search result","properties":{"code":{"description":"0 - found, 1 - not found","format":"int32","type":"integer"},"text":{"description":"search result description","type":"string"}},"type":"object"},"ServerError":{"description":"Internal server error","properties":{"error":{"default":"InternalServerError","description":"Error name","type":"string"},"message":{"default":"An internal server error occurred, please contact the system administrator with information on the error","description":"Description of the request error","type":"string"}},"type":"object"},"TopDirector":{"description":"Top director","properties":{"name":{"description":"Top director name","type":"string"},"role":{"description":"Top director role","type":"string"}},"type":"object"},"TradeStatus":{"properties":{"code":{"description":"Trade status code","type":"string"},"date":{"description":"Trade status date (Date in ISO 8601 standard)","type":"string"},"text":{"description":"Trade status description","type":"string"}},"type":"object"}},"securitySchemes":{"OAuth2":{"flows":{"clientCredentials":{"scopes":{},"tokenUrl":"https://api.roaring.io/token"}},"type":"oauth2"}}},"info":{"description":"Fetch company/companies overview(s)\nVerify and Monitor Company Information with Company Information API\nThe Company Information API provides crucial insights into a business’s identity, structure, and status. This data helps create smooth customer journeys, make secure, informed decisions, and reduce exposure to risks.\n\nThe API offers:\n\n**Current company data, including:**\n\n- Company name and address\n- Status and industry\n- Number of employees\n- Top-executive\n\n**Use case:**\nA financial institution onboarding a new B2B customer uses the Company Information API to check the company’s address and leadership history, ensuring that they understand any shifts in the company’s structure and potential risks before finalizing a business relationship.\n\n\n# Spanish Industry Codes\nFrom the 27th November 2025, the Spanish industry code standard is CNAE2025.  \nThis standard is aligned to NACE Rev. 2.1\n\nThe change affects all active companies.\n\n\n# Spanish Legal Group Codes\nCode|Letter code| Description EN | Description ES  \n --- | --- | --- | --- \n0||Proprietor|Autónomo\n1|AIE|Economic Interest Grouping|Agrupación de Interés Económico\n2|AEIE|European Economic Interest Grouping|Agrup. Eur. de Interés Económico\n3||Association|Asociación\n4|CDB|Basic Sports Club|Club Deportivo Básico\n5|CDE|Elementary Sports Club|Club Deportivo Elemental\n6|CB|Joint Ownership|Comunidad de Bienes\n7||Association of Property Owners under Horizontal Property Regime|Comunidad de Propietarios en Régimen de Propiedad Horizontal\n8|CIR|Congregation or Religious Institution|Congregación o Institución Religiosa\n9||Local Corporation|Corporación Local\n10|EPSV|Voluntary Social Welfare Entity|Entidad de Previsión Social Voluntaria\n11||Fund|Fondo\n12||Foundation|Fundación\n13||Mutual Insurance Company|Mutua\n14|MPS|Mutual Social Welfare Trust|Mutualidad de Previsión Social\n15||Independent Body|Organismo Autónomo\n16||Public Administration Body|Órgano de la Administración\n17||Political Party|Partido Político\n19|SAT|Agrarian Transformation Company|Sociedad Agraria de Transformación\n20|SA|Public Limited Company|Sociedad Anónima\n21|SAD|Public Limited Sports Company|Sociedad Anónima Deportiva\n22|SE|European Public Limited-liability Company|Sociedad Anónima Europea\n23|SAL|Labour Public Limited Company|Sociedad Anónima Laboral\n24|SAU|Single-member Public Limited Company|Sociedad Anónima Unipersonal\n25||Private Partnership|Sociedad Civil\n26|SC|General Partnership / General Liability Partnership|Sociedad Colectiva / Sociedad de Responsabilidad Colectiva\n27||Limited Partnership with Share Capital|Sociedad Comanditaria por Acciones\n28||Simple Limited Partnership / Limited Partnership|Sociedad Comanditaria Simple /Sociedad en Comandita\n29||Cooperative|Sociedad Cooperativa\n30|SCE|European Cooperative Society|Sociedad Cooperativa Europea\n31|SGR|Mutual Guarantee Society|Sociedad de Garantía Recíproca\n32|SL|Limited Company|Sociedad Limitada\n33|SLL|Labour Limited Company|Sociedad Limitada Laboral\n34|SLNE|New Business Limited Company|Sociedad Limitada Nueva Empresa\n35|SLU|Single-member Private Limited Company|Sociedad Limitada Unipersonal\n36||Branch in Spain|Sucursal en España\n37|UTE|Joint Venture|Unión Temporal de Empresas\n38||Non-Resident Entity|Entidad no Residente\n39||Savings Bank|Caja\n40||Non-Profit Entity|Entidad no Lucrativa\n43|SLP|Professional Limited Company|Sociedad Limitada Profesional\n44|SAP|Professional Public Limited Company|Sociedad Anónima Profesional\n45|SCPP|Professional Private Partnership|Sociedad Civil Profesional\n46|APIE|Port Economic Interest Grouping|Agrupación Portuaria de Interés Económico\n47|SAM|Municipal Public Limited Company|Sociedad Anónima Municipal\n49|SLLP|Professional Labour Limited Company|Sociedad Limitada Laboral Profesional\n50||Port Stevedores Management Public Limited Company|Sociedad Anónima de Gestión de Estibadores Portuarios\n51|AIU|Urban Development Interest Grouping|Agrupación de Interés Urbanístico\n53|ESPJ|Unincorporated entity|Entidad sin personalidad jurídica\n\n# Spanish Status Codes\nNote that there are three different types of statuses for Spanish companies. \n\n- Latest Confirmed Activity Status\n- Trade Activity Status\n- Bankruptcy information Status\n\nA company can have a value set in more than one of these code types at the same time. The latest value for each code is displayed, as well as the date when it was set. The most reliable information is the status code with the most recent date.\n\n\n# Spanish Latest Confirmed Activity Status Codes\nBelow is a list of available Latest Confirmed Activity status codes for a Spanish company. \nThe information is displayed as a code with a descriptive text. Also, the date of the last status change is supplied.\n\n\n| Code | Description (English) |\n| --- | --- |\n01 | We have confirmed that this firm is active.\n02 | We have confirmed that this firm is active, but it has not provided us with information.\n03 | We have obtained information from this firm, but according to the firm, the company is not operational.\n04 | It has not been possible to locate this firm with the contact details we have, and we have no information indicating that it is operating elsewhere.\n\n# Spanish Trade Status Codes\nBelow is a list of available Trade status codes for a Spanish company. \nThe information is displayed as a code with a descriptive text. Also, the date of the last status change is supplied.\n\n| Code | Description (English) |\n| --- | --- |\n1 | Dissolution. Split\n2 | Dissolution. Merger\n3 | Dissolution. Voluntary\n4 | Dissolution. Other causes\n5 | Dissolution Sixth Transitory Provision, Paragraph 2, T.R. (revised text) of L.S.A. (Public Limited Liability Companies Act) dated 22/12/89\n6 | Dissolution. Judicial\n7 | Dissolution. Global assignment of assets and liabilities\n8 | Liquidation\n9 | Reactivation of the Company (Art. 242 of the Companies Registry Regulations)\n10 | Active\n11 | Dissolution\n\n\n# Spanish Bankruptcy Status Codes\nBelow is a list of available Bankruptcy status codes for a Spanish company. The information is displayed as a code with a descriptive text. Also, the date of the last status change is supplied.\n\n| Code | Description (English) |\n| --- | --- |\n15 | Bankruptcy situation. Statement\n16 | Bankruptcy situation. Appointment of Administrators\n17 | Bankruptcy situation. Suspension Faculties\n18 | Bankruptcy situation. Qualification\n19 | Bankruptcy situation. Revocation of Administrators\n20 | Bankruptcy situation. Opening Phase Settlement\n23 | Bankruptcy situation. Opening of the Agreement Phase\n24 | Bankruptcy situation. Conclusion of the Contest\n25 | Bankruptcy situation. Approval of the Agreement\n26 | Bankruptcy situation. Fulfilled Agreement\n27 | Bankruptcy situation. End of the Common Phase\n30 | Bankruptcy situation. The piece file is approved\n32 | [CS] Bankruptcy situation / application\n34 | [CF] Bankruptcy situation / fortuitous\n36 | [CCL] Bankruptcy / guilty situation\n37 | [CRC] Bankruptcy situation / reopening of bankruptcy\n\n\n","title":"Company Information","version":"1.0","x-logo":{"url":"https://assets.roaring.io/svg/company-overview-v3.1.svg"}},"openapi":"3.0.1","paths":{"/{companyId}":{"get":{"description":"It supports date parameter to find overview up to date\n\n### Sandbox examples\nIn order to test the service, please use the following values in the Sandbox environment:\n\n| Description | URL |\n| - | - |\n| Sole Trader, deregistered | [/es/company/overview/1.0/33240116X](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzMzMjQwMTE2WA==) |\n| Private Partnership | [/es/company/overview/1.0/J00000018](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0owMDAwMDAxOA==) |\n| Limited Company | [/es/company/overview/1.0/B00000018](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0IwMDAwMDAxOA==) |\n| Public limited company with bankruptcy | [/es/company/overview/1.0/A00000042](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0EwMDAwMDA0Mg==) |\n| Deregistered Limited company example 2 | [/es/company/overview/1.0/B00000109](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0IwMDAwMDEwOQ==) |\n| Congregation or Religious Institution | [/es/company/overview/1.0/R0000001H](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL1IwMDAwMDAxSA==) |\n| Public Limited Sports Company with Trade status and Bankruptcy status | [/es/company/overview/1.0/A00000026](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0EwMDAwMDAyNg==) |\n| General Partnership / General Liability Partnership | [/es/company/overview/1.0/C00000018](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0MwMDAwMDAxOA==) |\n| Deregistered Limited Company | [/es/company/overview/1.0/A00000034](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0EwMDAwMDAzNA==) |\n| Limited company company id B00000091 | [/es/company/overview/1.0/B00000091](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0IwMDAwMDA5MQ==) |\n| Limited company with chairperson as top director | [/es/company/overview/1.0/A00000059](#L2VzL2NvbXBhbnkvb3ZlcnZpZXcvMS4wL0EwMDAwMDA1OQ==) |\n","operationId":"view","parameters":[{"description":"id of company","in":"path","name":"companyId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverviewsResult"}}},"description":"OK, successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}},"description":"Returned when something is wrong in the request, e.g. failed argument validation or arguments are missing"},"404":{"description":"Requested resource could not be found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}},"description":"An internal server error occurred, please contact the system administrator with information on the error"}},"summary":"Find overview by company id","tags":["OverviewEs"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/es/company/overview/1.0/{companyId}'"}]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/es/company/overview/1.0"}],"x-category":"company","x-countries":["es"],"x-id":"OverviewApiEs"}