Get Company Data and Documents

curl --request POST \ --url https://api.topograph.co/v2/company \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' { "id": "932884117", "countryCode": "FR", "dataPoints": [ "company", "legalRepresentatives" ], "documents": [ "1c932de4-4610-5506-b48d-4e62529d58e8" ], "graphContinueFromNodeIds": [ "FR:12345", "DE:HRB999" ], "metadata": {}, "graphMaxBudget": 1000, "graphInteractive": false, "profileMaxBudget": 500, "mode": "verification", "fast": true, "authoritative": true, "maxBudget": 200, "agenticEnrichment": true } '

{ "request": { "country": "FR", "dataPoints": [ "<string>" ], "documents": [ "<string>" ], "companyId": "932884117", "requestId": "request-12345", "dataStatus": { "dataPoints": {}, "documents": {} }, "metadata": {}, "enrichmentReport": "<string>", "companyLegalName": "<string>", "workspace": {} }, "company": { "countryCode": "FR", "id": "932884117", "identifiers": { "VAT": "02580590541", "Codice Fiscale": "RSSMRA70A01H501U", "CCIAA": "TO", "REA Code": "1234567" }, "taxId": { "type": "eu_vat", "value": "27443061841", "country": "FR", "verification": { "status": "verified", "verifiedAt": "2024-01-15T10:30:00Z", "verifiedName": "TOPOGRAPH SAS", "verifiedAddress": "123 RUE DE PARIS, 75001 PARIS", "consultationNumber": "WAPIAAAAW1234567890" } }, "legalName": "Topograph", "legalNameInEnglish": "Test Display Hong Kong Trading Limited", "commercialNames": [ "Topograph", "TopographHQ" ], "legacyLegalNames": [ "Semaphore", "SemaphoreHQ" ], "legacyCommercialNames": [ "Semaphore", "SemaphoreHQ" ], "status": { "localName": "active", "active": true, "statusDetails": { "status": "ACTIVE", "closureReason": "BANKRUPTCY", "closureDate": "2024-01-15", "insolvencyStartDate": "2023-12-01", "additionalInfo": "Company entered voluntary liquidation due to retirement of owner" } }, "registrationDate": "2024-04-22", "incorporationDate": "2024-04-15", "legalForm": { "localName": "EURL, entreprise unipersonnelle à responsabilité limitée", "englishTranslation": "Single Member Limited Liability Company", "semaphoreStandard": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "F8DD", "isAIEnriched": true }, "capital": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "activities": { "NACE": [ { "code": "62.01", "description": "Computer programming activities" } ], "ISIC": [ { "code": "J620", "description": "Computer programming, consultancy and related activities" } ] }, "activityDescription": "Development of software solutions and IT consulting services", "legalAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "phones": [ "+33123456789", "+33987654321" ], "website": "https://www.example.com", "employeeCount": { "exact": 150, "min": 100, "max": 200, "lastUpdated": "2024-03-15", "isEstimate": false } }, "ultimateBeneficialOwners": [ { "gender": "Female", "name": { "fullName": "John Doe" }, "birthDate": { "day": 15, "month": 7, "year": 1980 }, "birthAddress": { "country": "FR", "city": "Paris", "street": "1 Rue de Rivoli", "postalCode": "75001" }, "nationality": "US", "residenceAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "control": { "controlType": "ownership-of-shares", "description": "The person holds more than 50% of the shares in the company.", "percentageDetails": [ { "type": "shares", "range": { "lower": 50, "upper": 75 } } ], "additionalDetails": "Direct ownership of shares" }, "identifiers": [ { "type": "<string>", "value": "<string>" } ], "entityId": "person_001" } ], "legalRepresentatives": [ { "type": "individual", "entityId": "person_001", "role": { "standardized": "Director", "localName": "Directeur", "englishTranslation": "Director", "iso5009Code": "GIDXNF", "semaphoreStandard": "Director" }, "startDate": "2022-01-01", "endDate": "2023-12-31", "individual": { "gender": "Female", "name": { "fullName": "John Doe" }, "birthDate": { "day": 15, "month": 7, "year": 1980 }, "birthAddress": { "country": "FR", "city": "Paris", "street": "1 Rue de Rivoli", "postalCode": "75001" }, "nationality": "US", "residenceAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "identifiers": [ { "type": "<string>", "value": "<string>" } ] }, "company": { "countryCode": "FR", "id": "932884117", "identifiers": { "VAT": "02580590541", "Codice Fiscale": "RSSMRA70A01H501U", "CCIAA": "TO", "REA Code": "1234567" }, "taxId": { "type": "eu_vat", "value": "27443061841", "country": "FR", "verification": { "status": "verified", "verifiedAt": "2024-01-15T10:30:00Z", "verifiedName": "TOPOGRAPH SAS", "verifiedAddress": "123 RUE DE PARIS, 75001 PARIS", "consultationNumber": "WAPIAAAAW1234567890" } }, "legalName": "Topograph", "legalNameInEnglish": "Test Display Hong Kong Trading Limited", "commercialNames": [ "Topograph", "TopographHQ" ], "legacyLegalNames": [ "Semaphore", "SemaphoreHQ" ], "legacyCommercialNames": [ "Semaphore", "SemaphoreHQ" ], "status": { "localName": "active", "active": true, "statusDetails": { "status": "ACTIVE", "closureReason": "BANKRUPTCY", "closureDate": "2024-01-15", "insolvencyStartDate": "2023-12-01", "additionalInfo": "Company entered voluntary liquidation due to retirement of owner" } }, "registrationDate": "2024-04-22", "incorporationDate": "2024-04-15", "legalForm": { "localName": "EURL, entreprise unipersonnelle à responsabilité limitée", "englishTranslation": "Single Member Limited Liability Company", "semaphoreStandard": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "F8DD", "isAIEnriched": true }, "capital": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "activities": { "NACE": [ { "code": "62.01", "description": "Computer programming activities" } ], "ISIC": [ { "code": "J620", "description": "Computer programming, consultancy and related activities" } ] }, "activityDescription": "Development of software solutions and IT consulting services", "legalAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "phones": [ "+33123456789", "+33987654321" ], "website": "https://www.example.com", "employeeCount": { "exact": 150, "min": 100, "max": 200, "lastUpdated": "2024-03-15", "isEstimate": false } }, "representedBy": { "gender": "Female", "name": { "fullName": "John Doe" }, "birthDate": { "day": 15, "month": 7, "year": 1980 }, "birthAddress": { "country": "FR", "city": "Paris", "street": "1 Rue de Rivoli", "postalCode": "75001" }, "nationality": "US", "residenceAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "identifiers": [ { "type": "<string>", "value": "<string>" } ] }, "representationMode": { "mode": "sole", "minimumSignatories": 2, "namedCoSigners": [ "Kázsmér János" ] } } ], "shareholders": [ { "type": "individual", "entityId": "person_001", "individual": { "gender": "Female", "name": { "fullName": "John Doe" }, "birthDate": { "day": 15, "month": 7, "year": 1980 }, "birthAddress": { "country": "FR", "city": "Paris", "street": "1 Rue de Rivoli", "postalCode": "75001" }, "nationality": "US", "residenceAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "identifiers": [ { "type": "<string>", "value": "<string>" } ] }, "company": { "countryCode": "FR", "id": "932884117", "identifiers": { "VAT": "02580590541", "Codice Fiscale": "RSSMRA70A01H501U", "CCIAA": "TO", "REA Code": "1234567" }, "taxId": { "type": "eu_vat", "value": "27443061841", "country": "FR", "verification": { "status": "verified", "verifiedAt": "2024-01-15T10:30:00Z", "verifiedName": "TOPOGRAPH SAS", "verifiedAddress": "123 RUE DE PARIS, 75001 PARIS", "consultationNumber": "WAPIAAAAW1234567890" } }, "legalName": "Topograph", "legalNameInEnglish": "Test Display Hong Kong Trading Limited", "commercialNames": [ "Topograph", "TopographHQ" ], "legacyLegalNames": [ "Semaphore", "SemaphoreHQ" ], "legacyCommercialNames": [ "Semaphore", "SemaphoreHQ" ], "status": { "localName": "active", "active": true, "statusDetails": { "status": "ACTIVE", "closureReason": "BANKRUPTCY", "closureDate": "2024-01-15", "insolvencyStartDate": "2023-12-01", "additionalInfo": "Company entered voluntary liquidation due to retirement of owner" } }, "registrationDate": "2024-04-22", "incorporationDate": "2024-04-15", "legalForm": { "localName": "EURL, entreprise unipersonnelle à responsabilité limitée", "englishTranslation": "Single Member Limited Liability Company", "semaphoreStandard": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "F8DD", "isAIEnriched": true }, "capital": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "activities": { "NACE": [ { "code": "62.01", "description": "Computer programming activities" } ], "ISIC": [ { "code": "J620", "description": "Computer programming, consultancy and related activities" } ] }, "activityDescription": "Development of software solutions and IT consulting services", "legalAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "phones": [ "+33123456789", "+33987654321" ], "website": "https://www.example.com", "employeeCount": { "exact": 150, "min": 100, "max": 200, "lastUpdated": "2024-03-15", "isEstimate": false } }, "sharePercentage": 25.5, "numberOfShares": 1000, "nominalCapitalHeld": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "paidInAmount": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" } } ], "subsidiaries": [ { "company": { "countryCode": "FR", "id": "932884117", "identifiers": { "VAT": "02580590541", "Codice Fiscale": "RSSMRA70A01H501U", "CCIAA": "TO", "REA Code": "1234567" }, "taxId": { "type": "eu_vat", "value": "27443061841", "country": "FR", "verification": { "status": "verified", "verifiedAt": "2024-01-15T10:30:00Z", "verifiedName": "TOPOGRAPH SAS", "verifiedAddress": "123 RUE DE PARIS, 75001 PARIS", "consultationNumber": "WAPIAAAAW1234567890" } }, "legalName": "Topograph", "legalNameInEnglish": "Test Display Hong Kong Trading Limited", "commercialNames": [ "Topograph", "TopographHQ" ], "legacyLegalNames": [ "Semaphore", "SemaphoreHQ" ], "legacyCommercialNames": [ "Semaphore", "SemaphoreHQ" ], "status": { "localName": "active", "active": true, "statusDetails": { "status": "ACTIVE", "closureReason": "BANKRUPTCY", "closureDate": "2024-01-15", "insolvencyStartDate": "2023-12-01", "additionalInfo": "Company entered voluntary liquidation due to retirement of owner" } }, "registrationDate": "2024-04-22", "incorporationDate": "2024-04-15", "legalForm": { "localName": "EURL, entreprise unipersonnelle à responsabilité limitée", "englishTranslation": "Single Member Limited Liability Company", "semaphoreStandard": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "F8DD", "isAIEnriched": true }, "capital": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "activities": { "NACE": [ { "code": "62.01", "description": "Computer programming activities" } ], "ISIC": [ { "code": "J620", "description": "Computer programming, consultancy and related activities" } ] }, "activityDescription": "Development of software solutions and IT consulting services", "legalAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "phones": [ "+33123456789", "+33987654321" ], "website": "https://www.example.com", "employeeCount": { "exact": 150, "min": 100, "max": 200, "lastUpdated": "2024-03-15", "isEstimate": false } }, "entityId": "company_001", "sharePercentage": 75, "totalSharePercentage": 80, "votingRightsPercentage": 75, "numberOfShares": 1000, "nominalCapitalHeld": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "paidInAmount": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "acquisitionDate": "2020-06-15", "endDate": "2024-03-15" } ], "establishments": [ { "name": "Main Office", "id": "EST-001", "creationDate": "2020-01-15", "endDate": "2023-12-31", "active": true, "address": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 } } ], "otherKeyPersons": [ { "type": "individual", "entityId": "person_001", "role": { "standardized": "Board Member", "localName": "Commissaire aux comptes", "englishTranslation": "Auditor", "semaphoreStandard": "Board Member" }, "startDate": "2022-01-01", "endDate": "2023-12-31", "individual": { "gender": "Female", "name": { "fullName": "John Doe" }, "birthDate": { "day": 15, "month": 7, "year": 1980 }, "birthAddress": { "country": "FR", "city": "Paris", "street": "1 Rue de Rivoli", "postalCode": "75001" }, "nationality": "US", "residenceAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "identifiers": [ { "type": "<string>", "value": "<string>" } ] }, "company": { "countryCode": "FR", "id": "932884117", "identifiers": { "VAT": "02580590541", "Codice Fiscale": "RSSMRA70A01H501U", "CCIAA": "TO", "REA Code": "1234567" }, "taxId": { "type": "eu_vat", "value": "27443061841", "country": "FR", "verification": { "status": "verified", "verifiedAt": "2024-01-15T10:30:00Z", "verifiedName": "TOPOGRAPH SAS", "verifiedAddress": "123 RUE DE PARIS, 75001 PARIS", "consultationNumber": "WAPIAAAAW1234567890" } }, "legalName": "Topograph", "legalNameInEnglish": "Test Display Hong Kong Trading Limited", "commercialNames": [ "Topograph", "TopographHQ" ], "legacyLegalNames": [ "Semaphore", "SemaphoreHQ" ], "legacyCommercialNames": [ "Semaphore", "SemaphoreHQ" ], "status": { "localName": "active", "active": true, "statusDetails": { "status": "ACTIVE", "closureReason": "BANKRUPTCY", "closureDate": "2024-01-15", "insolvencyStartDate": "2023-12-01", "additionalInfo": "Company entered voluntary liquidation due to retirement of owner" } }, "registrationDate": "2024-04-22", "incorporationDate": "2024-04-15", "legalForm": { "localName": "EURL, entreprise unipersonnelle à responsabilité limitée", "englishTranslation": "Single Member Limited Liability Company", "semaphoreStandard": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "F8DD", "isAIEnriched": true }, "capital": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "activities": { "NACE": [ { "code": "62.01", "description": "Computer programming activities" } ], "ISIC": [ { "code": "J620", "description": "Computer programming, consultancy and related activities" } ] }, "activityDescription": "Development of software solutions and IT consulting services", "legalAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "phones": [ "+33123456789", "+33987654321" ], "website": "https://www.example.com", "employeeCount": { "exact": 150, "min": 100, "max": 200, "lastUpdated": "2024-03-15", "isEstimate": false } } } ], "graph": {}, "documents": { "tradeRegisterExtract": { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" }, "certifiedTradeRegisterExtract": { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" }, "financialStatements": [ { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>", "period": { "startDate": { "year": 123, "month": 123, "day": 123 }, "endDate": { "year": 123, "month": 123, "day": 123 } }, "extractedFinancialData": { "fiscalYear": {}, "approvalDate": "<string>", "currency": "<string>", "accountingStandard": "IFRS", "statementType": "consolidated", "analysis": { "summary": "<string>", "narrativeAnalysis": "<string>", "healthScore": 123, "overallRisk": "low", "ratios": { "currentRatio": 123, "quickRatio": 123, "debtToEquity": 123, "netProfitMargin": 123, "returnOnEquity": 123, "revenueGrowth": 123 }, "insights": [ { "category": "liquidity", "title": "<string>", "description": "<string>", "riskLevel": "low", "metricValue": "<string>", "recommendation": "<string>" } ], "strengths": [ "<string>" ], "concerns": [ "<string>" ], "trends": { "revenueDirection": "increasing", "profitabilityDirection": "improving", "debtDirection": "decreasing" } }, "incomeStatement": {}, "balanceSheet": {} } } ], "articlesOfAssociation": [ { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" } ], "ultimateBeneficialOwnersCertificate": { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" }, "lastFiscalYearFinancialStatement": { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" }, "officialPublications": [ { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" } ], "annualReturns": [ { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" } ], "certificateOfGoodStanding": { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" }, "otherDocuments": [ { "id": "<string>", "name": "<string>", "format": "<string>", "description": "<string>", "estimatedDeliverySeconds": 123, "url": "<string>", "pdfUrl": "<string>", "blobName": "<string>", "price": 123, "priceMarkup": 123, "date": "<string>" } ] }, "companyRelationships": [ { "relation": "mergedFrom", "company": { "countryCode": "FR", "id": "932884117", "identifiers": { "VAT": "02580590541", "Codice Fiscale": "RSSMRA70A01H501U", "CCIAA": "TO", "REA Code": "1234567" }, "taxId": { "type": "eu_vat", "value": "27443061841", "country": "FR", "verification": { "status": "verified", "verifiedAt": "2024-01-15T10:30:00Z", "verifiedName": "TOPOGRAPH SAS", "verifiedAddress": "123 RUE DE PARIS, 75001 PARIS", "consultationNumber": "WAPIAAAAW1234567890" } }, "legalName": "Topograph", "legalNameInEnglish": "Test Display Hong Kong Trading Limited", "commercialNames": [ "Topograph", "TopographHQ" ], "legacyLegalNames": [ "Semaphore", "SemaphoreHQ" ], "legacyCommercialNames": [ "Semaphore", "SemaphoreHQ" ], "status": { "localName": "active", "active": true, "statusDetails": { "status": "ACTIVE", "closureReason": "BANKRUPTCY", "closureDate": "2024-01-15", "insolvencyStartDate": "2023-12-01", "additionalInfo": "Company entered voluntary liquidation due to retirement of owner" } }, "registrationDate": "2024-04-22", "incorporationDate": "2024-04-15", "legalForm": { "localName": "EURL, entreprise unipersonnelle à responsabilité limitée", "englishTranslation": "Single Member Limited Liability Company", "semaphoreStandard": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "F8DD", "isAIEnriched": true }, "capital": { "amount": 1000, "currency": "EUR", "formatted": "1000.00 €" }, "activities": { "NACE": [ { "code": "62.01", "description": "Computer programming activities" } ], "ISIC": [ { "code": "J620", "description": "Computer programming, consultancy and related activities" } ] }, "activityDescription": "Development of software solutions and IT consulting services", "legalAddress": { "addressLine1": "10 rue de la Fraternité", "city": "Bagnolet", "postalCode": "93170", "region": "FR", "countryCode": "FR", "state": "Île-de-France", "addressLine2": "Topograph Building", "poBox": "PO Box 123", "careOf": "c/o John Doe", "latitude": 59.9139, "longitude": 10.7522 }, "phones": [ "+33123456789", "+33987654321" ], "website": "https://www.example.com", "employeeCount": { "exact": 150, "min": 100, "max": 200, "lastUpdated": "2024-03-15", "isEstimate": false } }, "effectiveDate": "<string>", "description": "<string>" } ], "dataSources": { "company": {}, "shareholders": { "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" }, "limitations": [ "<string>" ], "items": [ { "entityId": "<string>", "fields": {}, "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } } ] }, "ultimateBeneficialOwners": { "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" }, "limitations": [ "<string>" ], "items": [ { "entityId": "<string>", "fields": {}, "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } } ] }, "legalRepresentatives": { "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" }, "limitations": [ "<string>" ], "items": [ { "entityId": "<string>", "fields": {}, "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } } ] }, "establishments": { "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" }, "limitations": [ "<string>" ], "items": [ { "entityId": "<string>", "fields": {}, "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } } ] }, "otherKeyPersons": { "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" }, "limitations": [ "<string>" ], "items": [ { "entityId": "<string>", "fields": {}, "overall": { "type": "live_from_registry", "register": "inpi", "documents": [ { "name": "Statuts constitutifs", "date": "2020-03-15", "reason": "Most recent confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } ], "analysis": "Inferred from 2021 confirmation statement showing 100% ownership by KCA Deutag International 3 Limited" } } ] }, "graph": { "nodes": {} } }, "enrichmentReport": "<string>" }

Authorizations

x-api-key

string

header

required

Query Parameters

transliterate

boolean

If true, transliterates non-Latin strings in the response to Latin script.

Body

application/json

Option 1
Option 2

string

required

The company id. In some countries, this might be a concatenation of the registry and city (e.g., in Germany: "Augsburg HRB 34617"). The search function will always return a usable company number. Check the documentation to see which number format is used for each country. Optional when graphContinueFromNodeIds is set — the server derives it from the parent request.

Example:

"932884117"

countryCode

enum<string>

required

The country code in ISO 3166-1 alpha-2 format (e.g., "FR" for France, "DE" for Germany). Optional when graphContinueFromNodeIds is set — the server derives it from the parent request.

Available options:

AT,

BE,

BG,

CH,

CN,

CZ,

CY,

DE,

DK,

EE,

ES,

FI,

FR,

GB,

GG,

GR,

HK,

HR,

HU,

IE,

IS,

IT,

JE,

LI,

LU,

LV,

MC,

MT,

MU,

NL,

NO,

PL,

PT,

RO,

RU,

SE,

SG,

SI,

SK,

VG

Example:

"FR"

dataPoints

enum<string>[]

The data points to retrieve: company, legalRepresentatives, otherKeyPersons, establishments, shareholders, subsidiaries, ultimateBeneficialOwners, availableDocuments, graph. Legacy: companyProfile (maps to company + legalRepresentatives for billing).

Available options:

companyProfile,

ultimateBeneficialOwners,

availableDocuments,

shareholders,

graph,

company,

legalRepresentatives,

otherKeyPersons,

establishments,

subsidiaries

Example:

["company", "legalRepresentatives"]

documents

string[]

List of document IDs to retrieve. Discover these IDs by requesting the "availableDocuments" data point first, then pass the returned IDs here in a follow-up request.

Example:

["1c932de4-4610-5506-b48d-4e62529d58e8"]

graphContinueFromNodeIds

string[]

Continue a previous graph request from specific leaf nodes. Each nodeId must refer to a budget_truncated node in the parent request's graph (discover them in the parent's response). When set, the new request is linked to the parent via mainRequestId, countryCode and id are derived from the parent, and BFS seeds from these leaves instead of the root company. Cost deduplication applies across the full request tree, so already-paid companies are not re-billed. If the parent request ran with graphInteractive: true, every continuation inherits that flag automatically (any client-supplied value is ignored) so chip-driven exploration stays one level at a time.

Example:

["FR:12345", "DE:HRB999"]

metadata

object

Arbitrary key-value string pairs to associate with the request. Limits: max 50 keys, keys up to 40 chars (longer keys are skipped), values up to 500 chars (longer values are truncated).

Show child attributes

graphMaxBudget

number

Maximum budget in credit cents for graph traversal. When the "graph" datapoint is requested, the traversal will stop once this budget is reached. If not provided, uses a default maximum. Ignored when graphInteractive is true.

Example:

1000

graphInteractive

boolean

Interactive graph mode. When true, the traversal fetches only the entry node (the root for an initial request, the seeded node for a continuation) and stops; its direct shareholders are returned as graph nodes — companies among them appear as budget_truncated chips that you can pass back into a follow-up request via graphContinueFromNodeIds. Every continuation under a parent that ran with graphInteractive: true is auto-flagged interactive (server-enforced) so chip-driven exploration stays one level at a time. Use this for deliberate, click-by-click exploration with predictable per-step cost. Ignores graphMaxBudget.

Example:

false

profileMaxBudget

number

Maximum budget in credit cents for company profile retrieval. For countries with variable pricing (e.g., Hungary), the request will fail with a budget_exceeded error if the actual cost exceeds this budget. The error includes the quoted price so the user can retry with a higher budget.

Example:

500

mode

enum<string>

Data retrieval mode. "verification" (default) selects authoritative live registry sources. "onboarding" selects the cheapest compatible fast source for form prefill and initial screening, and marks unsupported datapoints as failed with error code "fast_source_unavailable" when no fast source exists.

Available options:

verification,

onboarding

fast

boolean

deprecated

Deprecated. Use mode: "onboarding" instead.

authoritative

boolean

deprecated

Deprecated. Use mode instead.

maxBudget

number

Hard cap on total block cost in credit cents. If the resolved blocks exceed this budget, the request fails with a budget_exceeded error including the actual cost and suggestion.

Example:

200

agenticEnrichment

boolean

Enable best-effort enrichment of legal representative person details (birth date, nationality, residence address) from official publications. Belgium only. Not all fields are guaranteed — depends on publication availability. Fixed 50 cent cost per request, charged only if enrichment yields results. Introduces enriching datapoint status while processing is in progress.

Example:

true

Response

200 - application/json

Search

Data

Pricing

Workspaces

Monitors

Billing Notifications

Get Company Data and Documents

Authorizations

Query Parameters

Body

Response

Search

Data

Pricing

Workspaces

Monitors

Billing Notifications

Documentation Index

Authorizations

Query Parameters

Body

Response