Skip to main content
POST
/
v2
/
onboarding
Get Onboarding Data (Deprecated)
curl --request POST \
  --url https://api.topograph.co/v2/onboarding \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "id": "932884117",
  "countryCode": "FR",
  "dataPoints": [
    "companyProfile"
  ],
  "metadata": {}
}
'
{
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.topograph.co/llms.txt

Use this file to discover all available pages before exploring further.

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

"FR"

​
dataPoints
enum<string>[]

The data points to retrieve. Only companyProfile is supported for onboarding.

Available options:
companyProfile
​
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).

Response

200 - application/json

Company onboarding 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.

​
subsidiaries
object[]

Companies in which the queried company holds equity (downstream participations). Includes any equity stake regardless of size — the relationship classification (controlled, associated, minority investment) is derived from sharePercentage by the consumer.

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