List User Profiles changedapi/user_profiles/list
Nearest release: v2.1.309, published 2 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+113added
Lines−2removed
From line
11
where the diff opens
First seen
21 Oct 2026
this site's first read of the page
Recorded edits2to this page, all time
The whole hunk
from line 11, old and new numbered
/
from line 11
1111
1212## Query parameters
1313
14- `enforcement_status: optional array of UserProfileEnforcementStatus`
15
16 Return only the user profiles whose `enforcement_status` is one of these values: `unrestricted`, `pending`, `restricted` or `banned`. Repeat the parameter to match any of several. With it set, a page may hold fewer than `limit` profiles, or none, and still carry a `next_page`: the service examines a bounded number of profiles per request, and only a null `next_page` means the listing is complete. Rejected with `invalid_request_error` under the `user-profiles-2026-09-04` and earlier beta headers. Fails with `overloaded_error` when a profile's enforcement actions cannot be read for the moment.
17
18 - `"unrestricted"`
19
20 - `"pending"`
21
22 - `"restricted"`
23
24 - `"banned"`
25
1426- `limit: optional number`
1527
1628 The maximum number of user profiles to return, from 1 to 100. Defaults to 20.
from line 105
93105
94106 format: date-time
95107
108 - `enforcement_actions: array of UserProfileEnforcementAction`
109
110 The enforcement actions open on this profile; empty when none is open. Absent under the `user-profiles-2026-09-04` and earlier beta headers.
111
112 - `UserProfileEnforcementActionRestriction object`
113
114 Anthropic has limited how it serves the end user until the action is resolved. The end user may still be served in part.
115
116 - `type: "restriction"`
117
118 - `id: string`
119
120 The action's ID (`enac_...`), stable while the action is open.
121
122 - `action: UserProfileEnforcementActionNextStep or null`
123
124 The next step on the action: `verify` or `null`. `verify`: the end user can clear it now by passing an identity check. `null`: there is nothing the end user can do now to clear it, including while Anthropic reviews an identity check the end user submitted.
125
126 - `expires_at: string or null`
127
128 When the action ends on its own, in RFC 3339 format; it stops showing once this time has passed. `null` when it has no end date, and always `null` when `reason` is `account_compromise`.
129
130 format: date-time
131
132 - `opened_at: string`
133
134 When Anthropic opened the action, in RFC 3339 format.
135
136 format: date-time
137
138 - `reason: UserProfileEnforcementActionReason`
139
140 Why Anthropic placed the limit: `unsupported_region`, `fraud_or_abuse`, `high_harm`, `usage_policy_violation`, `account_compromise` or `unspecified`.
141
142 - `"unsupported_region"`
143
144 - `"fraud_or_abuse"`
145
146 - `"high_harm"`
147
148 - `"usage_policy_violation"`
149
150 - `"account_compromise"`
151
152 - `"unspecified"`
153
154 - `UserProfileEnforcementActionBan object`
155
156 Anthropic has stopped serving the end user where the ban applies and does not plan to serve them there again.
157
158 - `type: "ban"`
159
160 - `id: string`
161
162 The action's ID (`enac_...`), stable while the action is open.
163
164 - `action: UserProfileEnforcementActionNextStep or null`
165
166 Always `null`: the end user cannot clear a ban.
167
168 - `expires_at: string or null`
169
170 Always `null`: a ban has no end date.
171
172 format: date-time
173
174 - `opened_at: string`
175
176 When Anthropic opened the action, in RFC 3339 format.
177
178 format: date-time
179
180 - `reason: UserProfileEnforcementActionReason`
181
182 Why Anthropic placed the limit: `unsupported_region`, `fraud_or_abuse`, `high_harm`, `usage_policy_violation`, `account_compromise` or `unspecified`.
183
184 - `enforcement_status: UserProfileEnforcementStatus`
185
186 Anthropic's enforcement status of this profile, from its open enforcement actions and any identity check under review, by the first rule that applies: `banned` while any open action is a `ban`; `pending` while a restriction that an identity check can clear is open, the end user has submitted that check, Anthropic's review of it has not ended, and no open action's `reason` is `account_compromise`; `restricted` while any action is open; `unrestricted` while none is. Absent under the `user-profiles-2026-09-04` and earlier beta headers.
187
188 - `"unrestricted"`
189
190 - `"pending"`
191
192 - `"restricted"`
193
194 - `"banned"`
195
96196 - `external_user_details: UserProfileExternalUserDetails`
97197
98198 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Every field is present, `null` until the platform supplies a value. Absent under the legacy `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers, which serve `reference_id` as the top-level `external_id` and, under `user-profiles-2026-08-18`, `onboarded_at` as `external_user_onboarded_at`.
from line 337
237337
238338```bash
239339curl https://api.anthropic.com/v1/user_profiles \
240 -H 'anthropic-version: 2023-06-01' \
241 -H "X-Api-Key: $ANTHROPIC_API_KEY"
340 -H 'anthropic-version: 2026-10-21' \
341 -H "Authorization: Bearer $ANTHROPIC_API_KEY"
242342```
243343
244344### Response (200)
from line 350
250350 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
251351 "access_type": "application",
252352 "created_at": "2026-03-15T10:00:00Z",
353 "enforcement_actions": [
354 {
355 "id": "enac_011CZkZCu8hGbp5mYRQgUmz9",
356 "action": "verify",
357 "expires_at": null,
358 "opened_at": "2026-10-02T19:30:00Z",
359 "reason": "fraud_or_abuse",
360 "type": "restriction"
361 }
362 ],
363 "enforcement_status": "unrestricted",
253364 "external_user_details": {
254365 "account_status": "active",
255366 "country": "US",
No line in this hunk matches that.