BusinessDetailsDto
Business-specific details for clients, including companies and sole traders.
Includes UK Companies House registration information, addresses, tax details, and SIC codes.
This information is typically populated from Companies House API or accounting platform integrations.
Properties
| Name | Type | Description |
|---|---|---|
| company | CompanyDetailsDto | |
| tradingAs | string | Trading name if different from the registered company name |
Trading name if different from the registered company name | ||
| postalAddress | string | Postal/correspondence address (may differ from registered address) |
Postal/correspondence address (may differ from registered address) | ||
| invoiceAddress | string | Address to use for invoicing purposes |
Address to use for invoicing purposes | ||
| dateOfTrading | string | The date when the business started trading (may differ from incorporation date) |
The date when the business started trading (may differ from incorporation date) | ||
| natureOfBusiness | string | Description of what the business does |
Description of what the business does | ||
| utr | string | Unique Taxpayer Reference for Corporation Tax or Self Assessment |
Unique Taxpayer Reference for Corporation Tax or Self Assessment | ||
| niNumber | string | National Insurance number (for sole traders) |
National Insurance number (for sole traders) | ||
| vat | VatDetailsDto | |
| payeRef | string | PAYE reference number for employers |
PAYE reference number for employers | ||
| accountsOfficeRef | string | HMRC Accounts Office reference number |
HMRC Accounts Office reference number | ||
JSON Example
{
"company": {
"number": "string",
"status": "...",
"incorporationDate": "2024-01-01T00:00:00Z",
"registeredAddress": "string",
"sicCodes": [
"..."
]
},
"tradingAs": "string",
"postalAddress": "string",
"invoiceAddress": "string",
"dateOfTrading": "2024-01-01T00:00:00Z"
}