Risk

API reference descriptions are provided in English to preserve the exact published contract.

GETList customer-visible risk decisionsrisk.decisions.list
POSTAppeal a risk decisionrisk.decisions.appeal
GETRead the account's use-case standingrisk.profile.list

List customer-visible risk decisions

GET/v1/accounts/{AC}/risk/decisions

risk.decisions.listSDK operation getV1AccountsByAcRiskDecisions

Required scope: risk:read.Paginated

Parameters

verdictstring (max 32 chars)query
limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/risk/decisions

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/risk/decisions" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Appeal a risk decision

POST/v1/accounts/{AC}/risk/decisions/{RD}/appeal

risk.decisions.appealSDK operation postV1AccountsByAcRiskDecisionsByRdAppeal

Required scope: risk:appeal.Idempotency-Key required

Parameters

RDstring (RD… SID)Required

Request body

reasonstring (max 2000 chars)Required

POST /v1/accounts/{AC}/risk/decisions/{RD}/appeal

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/risk/decisions/RD.../appeal" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

Responses

Read the account's use-case standing

GET/v1/accounts/{AC}/risk/profile

risk.profile.listSDK operation getV1AccountsByAcRiskProfile

Required scope: risk:read.

GET /v1/accounts/{AC}/risk/profile

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/risk/profile" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses