Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
getList UsersgetGet UsergetCurrent UserspostLatest IdentifiesdelDelete User
AnalyticsUsers

Latest Identifies

Returns the property bags of the 5 most recently seen identified users. Intended as a sample for previewing what identify data is arriving. For a full list use List Users, and for one specific user use Get User.

POST
/projects/{projectId}/analytics/latest-identifies

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project to read identifies from.

Request Body

application/json

fieldsarray<string>

Return only these property names, e.g. ["email", "name"]. Omit for every stored property.

limitnumber

Accepted but not applied. The underlying query is fixed to the 5 most recently seen contacts.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://www.saasco.com/api/v2/projects/string/analytics/latest-identifies" \  -H "Content-Type: application/json" \  -d '{}'
{
  "meta": [
    {
      "name": "string",
      "type": "string"
    }
  ],
  "rows": 0,
  "statistics": {
    "bytes_read": 0,
    "elapsed": 0,
    "rows_read": 0
  },
  "usage": {
    "cost": 0,
    "duration": 0,
    "metricCount": 0
  },
  "data": [
    {
      "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": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Current Users

Counts visitors seen in the last `minutes` minutes: the live-visitors number. Optional filters narrow the count to a segment (country, device, browser, UTM tags). Returns a single row holding the visit count.

Delete User

Erases a user's stored identify properties for GDPR-style deletion requests. Scope is narrow and worth noting: it clears the identify record only. Tracked events stay, and the CRM contact is untouched (use Delete Contact for that). The delete runs as an asynchronous job, so the user can still surface in queries for a short window after this returns 200.