CompanyInfo

Company registry information

type CompanyInfo {
  registrationNumber: String!
  name: String
  tradeName: String
  registrationDate: Date
  legalFormCode: String
  vatNumber: String
  taxIdentificationNumber: String
  businessActivityDescription: String
  businessClassificationCode: String
  address: AddressInfo
  headcount: CompanyHeadcount
  forecastYearlyIncome: ForecastYearlyIncome
  monthlyPaymentVolume: MonthlyPaymentVolume
  regulatoryClassification: RegulatoryClassification
  websites: [String!]
  ultimateBeneficialOwners: [UltimateBeneficialOwner]
  representatives: [OnboardingRepresentative]
  companyType: CompanyType
}

Fields

`CompanyInfo.registrationNumber` ● `String!` non-null scalar

Registration number (e.g., SIREN for France)

Maximum 50 characters

`CompanyInfo.name` ● `String` scalar

Company legal name

Maximum 100 characters
Allowed characters: letters (including international characters), numbers, punctuation, and special symbols (¿, ¡, @, [, ], |, ', ', ?, =)

`CompanyInfo.tradeName` ● `String` scalar

Trade name (if different from legal name)

Maximum 100 characters
Same character restrictions as company name (no URLs or HTML special characters)

`CompanyInfo.registrationDate` ● `Date` scalar

Company registration date

Format: YYYY-MM-DD (e.g., 2020-01-15)
Must be a date in the past or today (not in the future)

`CompanyInfo.legalFormCode` ● `String` scalar

Legal form of the company

`CompanyInfo.vatNumber` ● `String` scalar

VAT identification number

Must follow EU VAT number format
Country-specific patterns (e.g., FR: 2 alphanumeric + 9 digits, DE: 9 digits, IT: 11 digits)
Supported countries: AT, BE, BG, CY, CZ, DE, DK, EE, EL/GR, ES, FI, FR, GB, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK
Country prefix is optional (e.g., both "FR12345678901" and "12345678901" are accepted for France)