Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedAgent setupWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference
Skills for agents

REST API

Quick start
getList UsersgetGet UsergetCurrent UserspostLatest IdentifiesdelDelete User
AnalyticsUsers

List Users

View as MarkdownAgent setup

Lists identified users for the project, most recently seen first, each with their full property bag. Only users who have been through an identify() call appear here. Anonymous visitors are counted by Current Users and Query Sessions but have no record to list.

GET
/projects/{projectId}/analytics/users

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project to list users from.

Query Parameters

limitnumber

Maximum number of users to return. Defaults to 100.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/projects/string/analytics/users"
[  {    "distinctId": "string",    "projectId": "string",    "timestamp": "string",    "properties": {      "age": 0,      "avatar": "http://example.com",      "birthday": "string",      "createdAt": "string",      "description": "string",      "displayName": "string",      "email": "user@example.com",      "firstName": "string",      "gender": "string",      "id": "string",      "lastName": "string",      "name": "string",      "phone": "string",      "title": "string",      "username": "string",      "website": "string",      "$id": "string",      "$lastSeen": "string",      "$lastIdentifiedAt": "string",      "$processedAt": "string",      "$unsubscribed": true,      "$subscribed": true,      "$unsubscribeReason": "manual",      "$unsubscribeSource": "string",      "$emailValidated": true,      "$lastEmailValidatedAt": "string",      "$emailValidationResult": "string",      "$emailScore": 0,      "$stripeCustomerId": "string",      "$os": "string",      "$browser": "string",      "$browserVersion": "string",      "$screenHeight": 0,      "$screenWidth": 0,      "$screenDpi": 0,      "$device": "string",      "$userAgent": "string",      "$ip": "string",      "$timezone": "string",      "$city": "string",      "$country": "string",      "$countryCode": "string",      "$continent": "string",      "$region": "string",      "$locale": "string",      "$latitude": 0,      "$longitude": 0,      "$referrer": "string",      "$referringDomain": "string",      "$initialReferrer": "string",      "$initialReferringDomain": "string",      "$utmSource": "string",      "$utmMedium": "string",      "$utmCampaign": "string",      "$utmTerm": "string",      "$utmContent": "string",      "$initialUtmSource": "string",      "$initialUtmMedium": "string",      "$initialUtmCampaign": "string",      "$initialUtmTerm": "string",      "$initialUtmContent": "string",      "$_toDelete": true,      "$_emailScoreActions": "string",      "property1": "string",      "property2": "string"    }  }]

Quick start

Authenticate with a project API key and make your first REST request.

Get User

Fetches the most recent identify record for one user, returning the full property bag last known for them: reserved fields like `email` and `name`, Saasco's `$`-prefixed system properties (geo, device, referrer, subscription state), and any custom properties you have sent.