Skip to content
API Reference
/
/
/
Get browser user agent

Get browser user agent

Request

Generate a user agent matching the requested operating system and browser type.

  • Preconditions: Firefox is only valid with Windows or macOS, and osVersion must be one of the supported releases.
  • Effect: none, but the result is not deterministic — the same request returns a different user agent each time. Do not use it as a cache key.
  • Completion: synchronous. Safe to retry.
  • Open API: only published kernels are used to build the user agent; no client information is read.
Security
OpenApiBearer
Bodyapplication/jsonrequired
osinteger(OperatingSystem)required

Operating system:

  • 1 — Windows
  • 2 — macOS
  • 3 — Android
  • 4 — iOS
  • 5 — Linux
Enum:12345
Example:1
osVersionstring

Operating system version. Defaults to an empty string.

Enum:"""Windows 7""Windows 8""Windows 10""Windows 11""macOS 12""macOS 13""macOS 14"
Example:"Windows 11"
vendorinteger(BrowserType)required

Browser type:

  • 1 — Chrome
  • 2 — Firefox
Enum:12
Example:1
mobileDevicestring

Mobile device model ID. Used for Android and iOS profiles.

Example:"pixel_8"
systemBitTypeinteger(SystemBitType)

System bitness. Defaults to 1:

  • 0 — 32-bit
  • 1 — 64-bit
Default:1
Enum:01
Example:1
architectureinteger(Architecture)

CPU architecture. Defaults to 0:

  • 0 — x86
  • 1 — ARM
Default:0
Enum:01
Example:0
curl -i -X POST \
  https://api.morelogin.com/env/advanced/ua/get \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "os": 1,
    "osVersion": "Windows 11",
    "vendor": 1,
    "systemBitType": 1,
    "architecture": 0
  }'

Responses

Success

Bodyapplication/json
codeintegerrequired

Return result code. 0 means success; other codes indicate exceptions.

Example:0
msgstring or nullrequired

Error message. Usually null on success.

Example:null
requestIdstring

Operation request ID. This field may be present when the request passes through the API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
dataobjectrequired
Response
{
  "code": 0,
  "msg": null,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d",
  "data": {
    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
    "resolution": { … },
    "mobileDevice": null
  }
}