Get a corporate
GET
/corporates Returns the corporate associated with the authentication token, including its company details, contact information, and current state.
Read the corporate overview for the corporate lifecycle and onboarding flow.
Request
Available on
SandboxProduction
No request parametersThis endpoint doesn’t accept query parameters or a request body.
Responses
200OK
Success
Headers
Body
application/json
CorporateCorporate · object · 14 fields
Response example
{ "id": { "type": "CONSUMER", "id": "123456789" }, "profileId": "10001", "tag": "customer-123", "rootUser": { "id": { "type": "CONSUMER", "id": "123456789" }, "name": "Alex", "surname": "Smith", "email": "[email protected]", "mobile": { "countryCode": "+44", "number": "7700900123" }, "companyPosition": "DIRECTOR", "active": true, "emailVerified": true, "mobileNumberVerified": true, "dateOfBirth": { "year": 1990, "month": 1, "day": 1 }, "tag": "customer-123", "locale": "en-GB", "brand": "Acme" }, "company": { "name": "Acme Ltd", "type": "SOLE_TRADER", "registrationNumber": "12345678", "registeredAddress": { "addressLine1": "1 High Street", "addressLine2": "Flat 2", "city": "London", "postCode": "W1A 1AA", "state": "Greater London", "country": "GB" }, "businessAddress": { "addressLine1": "1 High Street", "addressLine2": "Flat 2", "city": "London", "postCode": "W1A 1AA", "state": "Greater London", "country": "GB" }, "countryOfRegistration": "GB", "incorporatedOn": { "year": 1990, "month": 1, "day": 1 } }, "industry": "ACCOUNTING", "sourceOfFunds": "LABOUR_CONTRACT", "sourceOfFundsOther": "Inheritance", "acceptedTerms": true, "ipAddress": "203.0.113.10", "baseCurrency": "GBP", "feeGroup": "DEFAULT", "creationTimestamp": 1786118400000, "retailQualifier": "RETAIL"}