POST
/
v2
/
company
curl --request POST \
  --url https://api.getsemaphore.com/v2/company \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "id": "932884117",
  "countryCode": "FR",
  "dataPoints": [
    "companyProfile"
  ],
  "documents": [
    "trade_register_extract"
  ]
}'
{
  "request": {
    "companyId": "932884117",
    "country": "FR",
    "requestId": "request-12345",
    "dataPoints": [
      "<string>"
    ],
    "documents": [
      "<string>"
    ],
    "dataStatus": {
      "dataPoints": {},
      "documents": {}
    }
  },
  "company": {
    "id": "932884117",
    "countryCode": "FR",
    "identifiers": {
      "SIREN": "932884117",
      "VAT": "FR42932884117"
    },
    "legalName": "Semaphore",
    "legalNameInEnglish": "Test Display Hong Kong Trading Limited",
    "commercialNames": [
      "Semaphore",
      "SemaphoreHQ"
    ],
    "status": {
      "localName": "active",
      "active": true
    },
    "registrationDate": "2024-04-22",
    "legalForm": {
      "localName": "EURL, entreprise unipersonnelle à responsabilité limitée",
      "englishTranslation": "Single Member Limited Liability Company",
      "semaphoreStandard": "Limited Liability Company",
      "iso20275Code": "F8DD"
    },
    "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é",
      "addressLine2": "Semaphore Building",
      "city": "Bagnolet",
      "postalCode": "93170",
      "region": "FR",
      "countryCode": "FR",
      "poBox": "PO Box 123",
      "careOf": "c/o John Doe",
      "state": "Île-de-France"
    }
  },
  "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é",
        "addressLine2": "Semaphore Building",
        "city": "Bagnolet",
        "postalCode": "93170",
        "region": "FR",
        "countryCode": "FR",
        "poBox": "PO Box 123",
        "careOf": "c/o John Doe",
        "state": "Île-de-France"
      },
      "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"
      }
    }
  ],
  "legalRepresentatives": [
    {
      "role": {
        "localName": "Directeur",
        "englishName": "Director",
        "iso5009Code": "GIDXNF",
        "semaphoreStandard": "Director"
      },
      "startDate": "2022-01-01",
      "endDate": "2023-12-31",
      "type": "individual",
      "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é",
          "addressLine2": "Semaphore Building",
          "city": "Bagnolet",
          "postalCode": "93170",
          "region": "FR",
          "countryCode": "FR",
          "poBox": "PO Box 123",
          "careOf": "c/o John Doe",
          "state": "Île-de-France"
        }
      },
      "company": {
        "id": "932884117",
        "countryCode": "FR",
        "identifiers": {
          "SIREN": "932884117",
          "VAT": "FR42932884117"
        },
        "legalName": "Semaphore",
        "legalNameInEnglish": "Test Display Hong Kong Trading Limited",
        "commercialNames": [
          "Semaphore",
          "SemaphoreHQ"
        ],
        "status": {
          "localName": "active",
          "active": true
        },
        "registrationDate": "2024-04-22",
        "legalForm": {
          "localName": "EURL, entreprise unipersonnelle à responsabilité limitée",
          "englishTranslation": "Single Member Limited Liability Company",
          "semaphoreStandard": "Limited Liability Company",
          "iso20275Code": "F8DD"
        },
        "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é",
          "addressLine2": "Semaphore Building",
          "city": "Bagnolet",
          "postalCode": "93170",
          "region": "FR",
          "countryCode": "FR",
          "poBox": "PO Box 123",
          "careOf": "c/o John Doe",
          "state": "Île-de-France"
        }
      }
    }
  ],
  "shareholders": [
    {
      "type": "individual",
      "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é",
          "addressLine2": "Semaphore Building",
          "city": "Bagnolet",
          "postalCode": "93170",
          "region": "FR",
          "countryCode": "FR",
          "poBox": "PO Box 123",
          "careOf": "c/o John Doe",
          "state": "Île-de-France"
        }
      },
      "company": {
        "id": "932884117",
        "countryCode": "FR",
        "identifiers": {
          "SIREN": "932884117",
          "VAT": "FR42932884117"
        },
        "legalName": "Semaphore",
        "legalNameInEnglish": "Test Display Hong Kong Trading Limited",
        "commercialNames": [
          "Semaphore",
          "SemaphoreHQ"
        ],
        "status": {
          "localName": "active",
          "active": true
        },
        "registrationDate": "2024-04-22",
        "legalForm": {
          "localName": "EURL, entreprise unipersonnelle à responsabilité limitée",
          "englishTranslation": "Single Member Limited Liability Company",
          "semaphoreStandard": "Limited Liability Company",
          "iso20275Code": "F8DD"
        },
        "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é",
          "addressLine2": "Semaphore Building",
          "city": "Bagnolet",
          "postalCode": "93170",
          "region": "FR",
          "countryCode": "FR",
          "poBox": "PO Box 123",
          "careOf": "c/o John Doe",
          "state": "Île-de-France"
        }
      },
      "sharePercentage": 25.5,
      "numberOfShares": 1000
    }
  ],
  "documents": {
    "tradeRegisterExtract": {
      "id": "<string>",
      "name": "<string>",
      "nameInEnglish": "<string>",
      "description": "<string>",
      "descriptionInEnglish": "<string>",
      "format": "<string>",
      "estimatedDeliverySeconds": 123,
      "sku": "abw-certified-register-extract",
      "url": "<string>",
      "blobName": "<string>",
      "price": 123,
      "priceMarkup": 123
    },
    "certifiedTradeRegisterExtract": {
      "id": "<string>",
      "name": "<string>",
      "nameInEnglish": "<string>",
      "description": "<string>",
      "descriptionInEnglish": "<string>",
      "format": "<string>",
      "estimatedDeliverySeconds": 123,
      "sku": "abw-certified-register-extract",
      "url": "<string>",
      "blobName": "<string>",
      "price": 123,
      "priceMarkup": 123
    },
    "financialStatements": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123,
        "period": {
          "startDate": {
            "year": 123,
            "month": 123,
            "day": 123
          },
          "endDate": {
            "year": 123,
            "month": 123,
            "day": 123
          }
        }
      }
    ],
    "articlesOfAssociation": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123,
        "date": "<string>",
        "isConsolidated": true
      }
    ],
    "ultimateBeneficialOwnersCertificate": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123
      }
    ],
    "otherDocuments": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123
      }
    ],
    "lastFiscalYearFinancialStatement": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123
      }
    ],
    "mostCompleteStatus": {
      "id": "<string>",
      "name": "<string>",
      "nameInEnglish": "<string>",
      "description": "<string>",
      "descriptionInEnglish": "<string>",
      "format": "<string>",
      "estimatedDeliverySeconds": 123,
      "sku": "abw-certified-register-extract",
      "url": "<string>",
      "blobName": "<string>",
      "price": 123,
      "priceMarkup": 123
    }
  },
  "documentsImproved": {
    "tradeRegisterExtract": {
      "id": "<string>",
      "name": "<string>",
      "nameInEnglish": "<string>",
      "description": "<string>",
      "descriptionInEnglish": "<string>",
      "format": "<string>",
      "estimatedDeliverySeconds": 123,
      "sku": "abw-certified-register-extract",
      "url": "<string>",
      "blobName": "<string>",
      "price": 123,
      "priceMarkup": 123
    },
    "certifiedTradeRegisterExtract": {
      "id": "<string>",
      "name": "<string>",
      "nameInEnglish": "<string>",
      "description": "<string>",
      "descriptionInEnglish": "<string>",
      "format": "<string>",
      "estimatedDeliverySeconds": 123,
      "sku": "abw-certified-register-extract",
      "url": "<string>",
      "blobName": "<string>",
      "price": 123,
      "priceMarkup": 123
    },
    "financialStatements": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123,
        "period": {
          "startDate": {
            "year": 123,
            "month": 123,
            "day": 123
          },
          "endDate": {
            "year": 123,
            "month": 123,
            "day": 123
          }
        }
      }
    ],
    "articlesOfAssociation": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123,
        "date": "<string>",
        "isConsolidated": true
      }
    ],
    "ultimateBeneficialOwnersCertificate": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123
      }
    ],
    "otherDocuments": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123
      }
    ],
    "lastFiscalYearFinancialStatement": [
      {
        "id": "<string>",
        "name": "<string>",
        "nameInEnglish": "<string>",
        "description": "<string>",
        "descriptionInEnglish": "<string>",
        "format": "<string>",
        "estimatedDeliverySeconds": 123,
        "sku": "abw-certified-register-extract",
        "url": "<string>",
        "blobName": "<string>",
        "price": 123,
        "priceMarkup": 123
      }
    ],
    "mostCompleteStatus": {
      "id": "<string>",
      "name": "<string>",
      "nameInEnglish": "<string>",
      "description": "<string>",
      "descriptionInEnglish": "<string>",
      "format": "<string>",
      "estimatedDeliverySeconds": 123,
      "sku": "abw-certified-register-extract",
      "url": "<string>",
      "blobName": "<string>",
      "price": 123,
      "priceMarkup": 123
    }
  }
}

Authorizations

​
x-api-key
string
header
required

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

Country code, which can be an ISO country code, or for the United States, a combination of "US" and the state code (e.g., "US-CA" for California).

Available options:
BE,
CH,
CN,
DE,
ES,
FR,
GB,
IT,
NL,
PT,
HK,
LU,
MT
Example:

"FR"

​
dataPoints
enum<string>[]

The data points to retrieve. Available data points are companyProfile, ultimateBeneficialOwners or availableDocuments.

Available options:
companyProfile,
ultimateBeneficialOwners,
availableDocuments
Example:
["companyProfile"]
​
documents
string[]

There are two ways to retrieve documents:

  1. Two-step process:

    • First, request the "availableDocuments" data point to get a list of all available documents with their IDs
    • Then, use these specific document IDs in a second request

  2. Direct access using smart IDs:

    • Use predefined smart IDs for quick access to common documents:
      • trade_register_extract: Latest trade register extract
      • certified_trade_register_extract: Latest certified trade register extract
      • last_fiscal_year_financial_statement: Latest financial statement
      • last_consolidated_article_of_association: Latest consolidated articles of association

Refer to our country coverage documentation to check which smart IDs are available for each country.

Example:
["trade_register_extract"]

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.

​
documents
object
​
documentsImproved
object