Skip to main content
POST
/
v2
/
company
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"
  ],
  "metadata": {},
  "graphMaxBudget": 1000,
  "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 €"
      }
    }
  ],
  "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": [
      "<string>"
    ],
    "ultimateBeneficialOwners": [
      "<string>"
    ],
    "legalRepresentatives": [
      "<string>"
    ],
    "establishments": [
      "<string>"
    ],
    "otherKeyPersons": [
      "<string>"
    ]
  },
  "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
​
id
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.

Example:

"932884117"

​
countryCode
enum<string>
required

The country code in ISO 3166-1 alpha-2 format (e.g., "FR" for France, "DE" for Germany).

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,
SE,
SG,
SI,
SK,
VG
Example:

"FR"

​
dataPoints
enum<string>[]

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

Available options:
companyProfile,
ultimateBeneficialOwners,
availableDocuments,
shareholders,
graph,
company,
legalRepresentatives,
otherKeyPersons,
establishments
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"]
​
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).

​
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.

Example:

1000

​
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

Company information

​
request
object
required

The request

​
company
object
required

The main profile information of the company, including, if available, details such as name, registration number, address, and other core data.

​
ultimateBeneficialOwners
object[]

The persons of significant control of the company, including, if available, their name, nationality, and other relevant details.

​
legalRepresentatives
object[]

The legal representatives of the company, which can be either individuals or companies.

​
shareholders
object[]

The shareholders of the company, which can be either individuals or companies.

​
establishments
object[]

The establishments of the company, including physical locations where business activities are conducted.

​
otherKeyPersons
object[]

Other key persons associated with the company who do not have legal signing authority, such as board members, auditors, and compliance officers.

​
graph
object
​
documents
object
​
companyRelationships
object[]
​
dataSources
object

Per-field data source provenance for each entity. Keys are field names, values describe the origin of the data.

​
enrichmentReport
string

Human-readable summary of enrichment results when agenticEnrichment was requested.