---
title: "Check the current status of a profile, including its lifecycle and persistence states."
method: GET
path: "/profiles/{profileId}/status"
tags: ["Profile"]
---

# Check the current status of a profile, including its lifecycle and persistence states.

`GET /profiles/{profileId}/status`

## Request

- Base URL: `http://localhost:5050`
- URL: `http://localhost:5050/profiles/{profileId}/status`
- Auth: none declared
- TypeScript: <https://skmtc.dev/kameleo-io/apis/kameleo-local-api/docs/profiles/:profileId/status/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `profileId` string, uuid, required

## Response `200`

OK.

- StatusResponse: Status information about the profile
  - `lifetimeState` 'created' | 'starting' | 'running' | 'terminating' | 'terminated' | 'locked' | 'loading' | 'unknown', required: Represents the lifetime states of a profile, indicating which actions can be performed with the associated browser engine at each state. Possible values are: - Created: Profile is created; the associated browser engine is not started. - Starting: The associated browser engine is starting. - Running: The associated browser engine is currently running. - Terminating: The associated browser engine is in the process of terminating. - Terminated: The associated browser engine is not running but has been started at least once. - Locked: The profile is currently being used by another user. - Loading: The profile data or the browser engine is syncing with the cloud storage. - Unknown: State of the profile is undefined.

## Other responses

- `404`: Profile not found.
- `default`: Error

## Changes

- **2026-08-03** `dc959e78ce25`: 2 warning
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `default`
- **2026-06-16** `4d1d53a322e2`: 4 warning, 14 info
  - removed the optional property `code` from the response with the `404` status
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `error` from the response with the `404` status
  - removed the optional property `error` from the response with the `default` status
  - …14 more
- **2026-03-05** `7d950a98d019`: 6 breaking, 8 warning, 4 info
  - removed the required property `errorCode` from the response with the `404` status
  - removed the required property `errorCode` from the response with the `default` status
  - removed the required property `status` from the response with the `404` status
  - removed the required property `status` from the response with the `default` status
  - …14 more

[Operation history](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/changes/profiles/:profileId/status/get.md)

---

[API](https://skmtc.dev/kameleo-io/apis/kameleo-local-api.md) - [All operations](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/revisions/d3225562612a?raw)