Get dynamic sub-account details

Get the status, usage, and connection password of one dynamic sub-account by ID.

API information

Item	Value
Method	GET
Path	/open-api/v1/dynamic/accounts/{id}
Authentication	X-API-Key
Processing	Synchronous

Path parameter

Parameter	Type	Required	Description
id	string	Yes	Dynamic sub-account ID

Query parameters are not accepted.

Request example

curl --request GET \
  --url 'https://api-test.puraroute.com/gin/open-api/v1/dynamic/accounts/1912345678901234567' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>'

Response fields

The response fields are the same as Create a dynamic sub-account.

limit_traffic_gb is always a non-null string with six decimal places; 0.000000 means unlimited.

Successful response example

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "1912345678901234567",
    "sub_account": "team_a_01",
    "password": "example-secret",
    "limit_traffic_gb": "10.000000",
    "lifetime_used_gb": "1.250000",
    "resource_status": "ACTIVE",
    "user_enabled": true,
    "flow_blocked": false,
    "available": true,
    "control_pending": false,
    "last_usage_sync_time": "2026-08-24T15:20:00.000+08:00",
    "create_time": "2026-08-20T10:00:00.000+08:00",
    "update_time": "2026-08-24T15:30:00.000+08:00"
  },
  "next": null
}

Possible error codes

code	Description
300001	The account does not exist or is inaccessible
400001	Authentication failed
400009	The path or request parameters are invalid
500000	System processing failed; the request did not complete

The response contains a password. Do not cache it or write it to ordinary logs.