---
title: "Get subaccount preferences"
method: GET
path: "/v4/account/subaccounts/{subAccountId}/preferences"
tags: ["Subaccounts"]
---

# Get subaccount preferences

`GET /v4/account/subaccounts/{subAccountId}/preferences`

## Request

- Base URL: `https://api.proxyscrape.com`
- URL: `https://api.proxyscrape.com/v4/account/subaccounts/{subAccountId}/preferences`
- Auth: API key in header `api-token`
- TypeScript: <https://skmtc.dev/proxyscrape/apis/proxyscrape-account-api/docs/v4/account/subaccounts/:subAccountId/preferences/get.ts> (a function with typed inputs; its response is checked against the schema)

Get preferences for a subaccount (label, visibility). Permission: `subaccount:read`.

## Path parameters

- `subAccountId` string, uuid, required

## Response `200`

Subaccount preferences

- object
  - `success` boolean
  - `data` object
    - `AccountID` string, uuid
    - `AccountType` string
    - `label` string
    - `is_hidden` boolean
    - `time_added` integer: Unix timestamp

## Other responses

- `401`: Unauthorized
- `404`: Subaccount not found

---

[API](https://skmtc.dev/proxyscrape/apis/proxyscrape-account-api.md) - [All operations](https://skmtc.dev/proxyscrape/apis/proxyscrape-account-api/llms.txt) - [OpenAPI document](https://skmtc.dev/proxyscrape/apis/proxyscrape-account-api/revisions/4e10267785e1?raw)