Docs : API : List Users
The List Users API lets you retrieve all the users of an app and their associated metadata by providing the app ID. The app ID can be obtained from the Admin panel. This endpoint is paginated.
curl 'https://v1.userbase.com/v1/admin/apps/$APP_ID/users?nextPageToken=$NEXT_PAGE_TOKEN' \
-XGET \
-H 'Authorization: Bearer $ACCESS_TOKEN'
Parameters
-
APP_ID - The app ID to retrieve.
-
NEXT_PAGE_TOKEN - The next page of users to retrieve.
-
ACCESS_TOKEN - Your access token.
Result
- nextPageToken [string] - Each response has a max limit of around 1mb of users. If this limit is reached, this token is provided in the response, and must be provided in the next request to get the next page of users.
- users [array]
- username [string] - The user's username.
- userId [string] - The user's unique identifier.
- appId [string] - The app id which the user belongs to.
- creationDate [string] - The timestamp when the user was created.
- email [string] - The user's email address, if available.
- deleted [string] - The timestamp when the user was deleted.
- profile [object] - The user's profile.
- protectedProfile [object] - The user's protected profile. The protected profile can only be modified by the Admin API, so it can be used for metadata that shouldn't by updated directly by the user (such as payment status info).
- testStripeData [object] - The user's relevant test Stripe data.
- customerId [string] - The users's unique customer identifier generated automatically by Stripe when the user succesfully purchases a subscription.
- subscriptionStatus [string] - The user's subscription status. Can be 'active', 'incomplete', 'incomplete_expired', 'past_due', 'canceled', or 'unpaid'. Each status is explained further here.
- trialExpirationDate [string] - The date the user's trial expires.
- cancelSubscriptionAt [string] - The date the user's subscription is set to be canceled.
- subscriptionId [string] - The users's unique subscription identifier generated automatically by Stripe when the user succesfully purchases a subscription.
- subscriptionPlanId [string] - The subscription plan the user is subscribed to.
- prodStripeData [object] - The user's relevant production Stripe data.
- customerId [string] - The users's unique customer identifier generated automatically by Stripe when the user succesfully purchases a subscription.
- subscriptionStatus [string] - The user's subscription status. Can be 'active', 'incomplete', 'incomplete_expired', 'past_due', 'canceled', or 'unpaid'. Each status is explained further here.
- trialExpirationDate [string] - The date the user's trial expires.
- cancelSubscriptionAt [string] - The date the user's subscription is set to be canceled.
- subscriptionId [string] - The users's unique subscription identifier generated automatically by Stripe when the user succesfully purchases a subscription.
- subscriptionPlanId [string] - The subscription plan the user is subscribed to.