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
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": "string", "surname": "string", "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": "string" }, "company": { "name": "string", "type": "SOLE_TRADER", "registrationNumber": "string", "registeredAddress": { "addressLine1": "string", "addressLine2": "string", "city": "string", "postCode": "string", "state": "string", "country": "string" }, "businessAddress": { "addressLine1": "string", "addressLine2": "string", "city": "string", "postCode": "string", "state": "string", "country": "string" }, "countryOfRegistration": "string", "incorporatedOn": { "year": 1990, "month": 1, "day": 1 } }, "industry": "ACCOUNTING", "sourceOfFunds": "LABOUR_CONTRACT", "sourceOfFundsOther": "string", "acceptedTerms": true, "ipAddress": "string", "baseCurrency": "GBP", "feeGroup": "string", "creationTimestamp": 0, "retailQualifier": "RETAIL"}