Skip to main content
GET/api/public/v1/profiles/{id}

profiles.get

One profile with its configuration, bound proxy, accounts (no secrets) and recent revisions.

Capability: profile.readMCP tool: profiles_get
View as Markdown

Parameters

NameTypeRequiredDescription
idpathstring (uuid)YesProfile id

Examples

curl "https://browlix.com/api/public/v1/profiles/<id>" \
  -H "Authorization: Bearer $BROWLIX_API_KEY"

Response

200 with { data, correlation_id }.

FieldTypeAlways presentDescription
dataobjectYes
data.idstring (uuid)Yes
data.numberintegerYesWorkspace-wide profile number (min -9007199254740991, max 9007199254740991)
data.namestringYes
data.state"active" | "trashed"Yes
data.revisionintegerYesSend as expected_revision when you change the profile (min -9007199254740991, max 9007199254740991)
data.os"windows" | "linux"Yes
data.kernelstringYes
data.network_mode"direct" | "proxy"Yes
data.groupobject | nullYes
data.group.idstring (uuid)Yes
data.group.namestringYes
data.tagsarray<object>Yes
data.tags[].idstring (uuid)Yes
data.tags[].namestringYes
data.tags[].colorstringYes
data.proxyobject | nullYes
data.proxy.idstring (uuid)Yes
data.proxy.namestringYes
data.proxy.scheme"http" | "https" | "socks5"Yes
data.proxy.hoststringYes
data.proxy.portintegerYes(min -9007199254740991, max 9007199254740991)
data.proxy.last_checkobject | nullNo
data.notesstringYes
data.accountsarray<object>YesAccounts without passwords or TOTP secrets
data.accounts[].idstring (uuid)Yes
data.accounts[].platformstringYes
data.accounts[].usernamestringYes
data.accounts[].has_passwordbooleanYes
data.accounts[].has_totpbooleanYes
data.accounts[].verifiedbooleanYes
data.accounts[].revisionintegerYes(min -9007199254740991, max 9007199254740991)
data.accounts[].updated_atstring (date-time)Yes
data.created_atstring (date-time)Yes
data.updated_atstring (date-time)Yes
data.last_opened_atstring (date-time) | nullYes
data.trashed_atstring (date-time) | nullYes
data.configobjectYes
data.config.os"windows" | "linux"Yes
data.config.kernelstringYes
data.config.user_agentobjectYes
data.config.user_agent.mode"derived" | "custom"Yes
data.config.user_agent.valuestringNo(min length 20, max length 512)
data.config.languagesobjectYes
data.config.languages.mode"proxy" | "custom"Yes
data.config.languages.valuearray<string>No(min 1 items, max 10 items)
data.config.timezoneobjectYes
data.config.timezone.mode"proxy" | "custom"Yes
data.config.timezone.valuestringNo(max length 64)
data.config.geolocationobjectYes
data.config.geolocation.permission"ask" | "allow" | "block"Yes
data.config.geolocation.source"proxy" | "custom"Yes
data.config.geolocation.latitudenumberNo(min -90, max 90)
data.config.geolocation.longitudenumberNo(min -180, max 180)
data.config.geolocation.accuracy_mintegerNo(min 1, max 100000)
data.config.webrtc"proxy" | "disabled" | "real"Yes
data.config.dns"proxy" | "system"Yes
data.config.screenobjectYes
data.config.screen.mode"auto" | "custom"Yes
data.config.screen.widthintegerNo(min 640, max 7680)
data.config.screen.heightintegerNo(min 480, max 4320)
data.config.hardwareobjectYes
data.config.hardware.cpu_coresintegerYes(min 0, max 64)
data.config.hardware.memory_gbintegerYes(min 0, max 64)
data.config.fingerprintobjectYes
data.config.fingerprint.canvas"noise" | "real"Yes
data.config.fingerprint.webgl_image"noise" | "real"Yes
data.config.fingerprint.webgl_metadata"masked" | "real"Yes
data.config.fingerprint.audio"noise" | "real"Yes
data.config.fingerprint.client_rects"noise" | "real"Yes
data.config.fingerprint.media_devices"masked" | "real"Yes
data.config.fingerprint.fonts"os_default" | "system"Yes
data.config.do_not_trackbooleanYes
data.config.proxy_failure"block" | "ask"Yes
data.startup_urlsarray<string>Yes
data.preferencesobjectYes
data.preferences.valuesobjectYes
data.preferences.sourcesobjectYes
data.preferences.templateobject | nullYes
data.preference_overridesobjectYes

New fields can appear at any time; ignore the ones you do not know.

Errors

CodeHTTPRetryable
UNAUTHENTICATED401No
FORBIDDEN403No
RATE_LIMITED429Yes
VALIDATION_FAILED422No
NOT_FOUND404No
DEPENDENCY_UNAVAILABLE503Yes
UNKNOWN500No

Every error code and when to retry

All operations