List users

Returns managed users grouped by your external_user_id values. Use it to see which end users have connected accounts in UniPost.
https://api.unipost.dev
GET/v1/users?{limit}
Authorization
In header ยท Bearer <token>
Query

Authorization

AuthorizationBearer <token>In header
Workspace API key.

Query Params

limit?integer
Maximum number of managed users to return. Default 25, max 100.

Response Body

200
data[]array
Managed users grouped by external_user_id.
data[].external_user_idstring
Your own stable end-user identifier.
data[].external_user_emailstring | null
Optional email captured during onboarding.
data[].account_countnumber
Total connected accounts for that managed user.
data[].platform_countsobject
Breakdown of connected accounts by platform.
data[].reconnect_countnumber
How many accounts need reconnect attention.
meta.totalnumber
Total number of managed users available for this profile/workspace scope.
meta.limitnumber
Applied list limit for this response.
request_idstring
Request identifier for debugging and support.
401
error.codestring
Usually "UNAUTHORIZED".
error.normalized_codestring
Lowercase alias such as "unauthorized".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED".
error.normalized_codestring
Lowercase alias such as "unauthorized".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.