Resolve the white-label branding/domain config for a company — looked up by explicit company_id, by referral_code (resolved to its company), or, if neither is given, inferred from the request Referer host (subdomain + domain matched against domain_prefix/domain_name). When a record is found it also live-checks the custom subdomain status via AWS Amplify (persisting active/inactive), pulls the latest theme settings and the partner referral code, and rewrites logo/favicon paths to versioned S3 URLs.
Auth: Both — authentication (top-level authenticated group), role-agnostic account/white-label prefix. When you supply company_id it must sit inside your own account tree. A partner can therefore resolve any partner/account/location company beneath it, while an account user reaches only its own part of the account tree. With no company_id/referral_code the resolver falls back to the Referer host and returns whatever public white-label matches, regardless of role.
Rate limit: No rate limit.
Request
- Body (all optional; if none given, falls back to
Refererhost):
| Field | Type | Required | Notes |
|---|---|---|---|
| company_id | integer | optional | Must be an existing account inside your own account tree (must be in caller's hierarchy). |
| referral_code | string | optional | Must be an existing referral code; resolved to its company_id if company_id absent. |
Response — { data. } envelope.
status(string) — always"success".theme_settings(object|null) — latestRsUserThemeSettingrow for the resolved company (id,user_id,company_id,theme_optionsJSON string, timestamps), or null if none.company(object) —{ name }of the resolved company (empty string if unresolved).data(object|array) — theRsWhiteLabelrow spread out (id,company_id,domain_name,domain_prefix,white_url,email,title,status, timestamps, nestedcompanyrelation) withlogo/login_logo/mobile_logo/faviconrewritten to versioned S3 URLs (or null), plussubDomainSetting(e.g."verified"/"Domain not found!"). Returns an empty array[]when no white-label record is found.instruction_file(string) — asset URL to the domain-setup PDF.partner_referral(string|null) — referral code of the owning partner (only present when a white-label record is found).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
