List contact activity Run in API Explorer
What the calling agent's contacts have done, newest first: listing views, saves, ratings, comments, showing requests and report views, each with the contact and what it was about: a listing, home value report, market report or CMA, told apart by its type.
Requires the contacts:read scope. Rate budget: 60 calls per 1 minute per credential (the list class).
Query parameters
-
Only this contact's activity; omit for the whole book. An id that is none of the agent's contacts is an empty page.
-
Comma-separated action types (e.g. view,save); defaults to the full published set.
Values are
view,save,unsave,hide,unhide,rated,comment,request_showing,open_house_view,home_report_view,market_alert_view, orcma_view. Default value is["view", "save", "unsave", "hide", "unhide", "rated", "comment", "request_showing", "open_house_view", "home_report_view", "market_alert_view", "cma_view"]. -
Only activity at or after this ISO-8601 timestamp; defaults to one year ago.
-
Only activity at or before this ISO-8601 timestamp.
-
Opaque cursor from the previous page's next_cursor; a cursor another list issued is refused.
-
Page size, 1 to 100.
Minimum value is
1, maximum value is100. Default value is25.
Responses
-
OK
-
The request is invalid;
fieldnames the offending input when there is one. A body that is not valid JSON is refused before the API runs, as a bare 400 with no body. -
Invalid or missing bearer token.
-
The credential was not granted the scope this call requires.
-
Not found, or not yours: the two are indistinguishable on purpose.
-
Rate limit exceeded;
Retry-Aftersays when to try again. -
Something went wrong on our side.
curl -H "Authorization: Bearer rs_agent_..." "https://www.realscout.com/api/agent/v1/activity?actions=view,save&limit=50"
{
"data": [
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDE=",
"action": "view",
"created_at": "2026-08-19T02:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": 3,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDI=",
"action": "save",
"created_at": "2026-08-19T01:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDM=",
"action": "unsave",
"created_at": "2026-08-19T00:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDQ=",
"action": "hide",
"created_at": "2026-08-18T23:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDU=",
"action": "unhide",
"created_at": "2026-08-18T22:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDY=",
"action": "rated",
"created_at": "2026-08-18T21:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": 4,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDc=",
"action": "comment",
"created_at": "2026-08-18T20:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDg=",
"action": "request_showing",
"created_at": "2026-08-18T19:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMDk=",
"action": "open_house_view",
"created_at": "2026-08-18T18:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "Property",
"id": "UHJvcGVydHktNDU2",
"mls_number": "ML81234567",
"address": "123 Main St",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"price": 1250000,
"status": "active",
"beds": 3,
"baths": 2.0,
"realscout_url": "https://www.realscout.com/agent/ls/123-main-st-san-jose-ca-95112",
"realscout_client_url": "https://danaagent.realscout.com/homesearch/listings/123-main-st-san-jose-ca-95112"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMTA=",
"action": "home_report_view",
"created_at": "2026-08-18T17:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "HomeReport",
"id": "SG9tZVJlcG9ydC03ODk=",
"address": "456 Oak Ave",
"city": "San Jose",
"state": "CA",
"zipcode": "95112",
"valuation": 1100000,
"realscout_url": "https://www.realscout.com/agent/users/123/home-reports/SG9tZVJlcG9ydC03ODk="
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMTE=",
"action": "market_alert_view",
"created_at": "2026-08-18T16:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "MarketAlert",
"id": "TWFya2V0QWxlcnQtMzIx",
"name": "Willow Glen",
"price_min": 800000,
"price_max": 1500000,
"realscout_url": "https://www.realscout.com/agent/users/VXNlci0xMjM=/market-activity-alerts/TWFya2V0QWxlcnQtMzIx"
}
},
{
"id": "SG9tZWJ1eWVyQWN0aW9uLTkwMTI=",
"action": "cma_view",
"created_at": "2026-08-18T15:11:00Z",
"contact": {
"id": "VXNlci0xMjM=",
"realscout_url": "https://www.realscout.com/agent/contacts/VXNlci0xMjM="
},
"rating": null,
"view_count": null,
"actionable": {
"type": "CmaReport",
"id": "Q21hUmVwb3J0LTY1NA==",
"title": "Nguyen — Willow Glen comps",
"subject_address": "789 Elm St, San Jose, CA, 95112",
"realscout_url": "https://www.realscout.com/agent/cma-reports/Q21hUmVwb3J0LTY1NA=="
}
}
],
"has_more": true,
"next_cursor": "bGlzdF9jb250YWN0X2FjdGl2aXR5fFd5SXlNREkyTFRBNExURTRJREUxT2pFeE9qQXdMakF3TURBd01EQXdNQ0JWVkVNaUxEa3dNVEpk"
}
{
"error": {
"code": "invalid_request",
"message": "actions must be a comma-separated subset of: view, save, unsave, hide, unhide, rated, comment, request_showing, open_house_view, home_report_view, market_alert_view, cma_view.",
"field": "actions",
"request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
}
}
{
"error": {
"code": "unauthorized",
"message": "Invalid or missing credentials.",
"request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
}
}
{
"error": {
"code": "missing_scope",
"message": "This call requires the contacts:read scope, which this credential was not granted.",
"request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
}
}
{
"error": {
"code": "not_found",
"message": "No endpoint at GET /api/agent/v1/activity.",
"request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
}
}
{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Try again in 30 seconds.",
"request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
}
}
{
"error": {
"code": "internal_error",
"message": "Something went wrong on our side.",
"request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
}
}