Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

getList UsersgetGet UsergetCurrent UserspostLatest IdentifiesdelDelete User

CRM

Email Marketing

Knowledge

Support

Projects

Users

List Users

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://www.saasco.com/api/v2/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"
    }
  }
]
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

What is Saasco?

An all-in-one marketing stack for SaaS companies. Connect once and only pay for what you use.

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.