Retrieve an app setting value

GET

/app-setting-values/{id}

Fetches a single app setting value record by its unique identifier. The record must belong to the authenticated entity — entity_id from the bearer token is applied as a scope guard so callers cannot retrieve settings that belong to other entities. The response includes an augmented component object with the resolved name of the entity or account the value is scoped to.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

App setting value found and returned successfully.

Bodyapplication/json

🟠401

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/app-setting-values/01HQZR2BKPFQ8MXJVT3G7LWN5' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Entity-level setting value

{
    "message": "App setting value retrieved successfully",
    "status": "success",
    "data": {
        "id": "01HQZR2BKPFQ8MXJVT3G7LWN5",
        "name": "max_daily_transfer_limit",
        "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
        "component_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
        "component_type": "entity",
        "value": 500000,
        "identity_id": "01HQZR2BKPFQ8MXJVT3G7LWNB",
        "component": {
            "id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "type": "entity",
            "name": "Acme Corp"
        },
        "created": 1754524800000,
        "updated": 1754524800000
    }
}

Modified at 2026-08-06 16:06:15

Delete an app setting value

List app setting values