Skip to main content
GET
/
api
/
v2
/
browser-profiles
/
{profile_id}
Retrieve a browser profile
curl --request GET \
  --url https://agp.eu.hcompany.ai/api/v2/browser-profiles/{profile_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "description": {},
  "browser_name": "<string>",
  "browser_version": "<string>",
  "s3_path": {},
  "file_size_bytes": {},
  "checksum": {},
  "usage_count": 123,
  "last_used_at": {},
  "labels": {},
  "created_at": "<string>",
  "updated_at": "<string>"
}
Fetches a single browser profile. Returns the profile object.

​
Path parameters

​
profile_id
string
required
The profile’s id (UUID).

​
The browser profile object

​
id
string
Unique profile identifier (UUID).
​
name
string
Human-readable label.
​
description
string | null
Optional free-text description.
​
browser_name
string
Browser the profile was captured with (for example chromium).
​
browser_version
string
Browser version string the profile was captured with.
​
s3_path
string | null
Internal storage path of the profile archive.
​
file_size_bytes
integer | null
Size of the stored archive in bytes.
​
checksum
string | null
SHA-256 checksum of the stored archive, computed at upload time.
​
usage_count
integer
Number of times the profile has been loaded into a session.
​
last_used_at
string | null
ISO 8601 timestamp of the last time the profile was loaded, or null if never used.
​
labels
object | null
Key-value metadata you set on the profile.
​
created_at
string
ISO 8601 creation timestamp.
​
updated_at
string
ISO 8601 timestamp of the last change.

​
Examples

curl "https://agp.eu.hcompany.ai/api/v2/browser-profiles/a1b2c3d4-5678-90ab-cdef-1234567890ab" \
  -H "Authorization: Bearer $HAI_API_KEY"
Response
{
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "name": "acme-prod-login",
  "description": null,
  "browser_name": "chromium",
  "browser_version": "131",
  "s3_path": "browser-profiles/finished/org_123/a1b2c3d4-5678-90ab-cdef-1234567890ab/profile.zip",
  "file_size_bytes": 102400,
  "checksum": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "usage_count": 3,
  "last_used_at": "2026-06-16T13:05:00Z",
  "labels": {"team": "qa"},
  "created_at": "2026-06-16T14:30:00Z",
  "updated_at": "2026-06-16T14:30:00Z"
}

​
Errors

StatusCause
404Profile not found or you don’t have access.