List contact activity Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://bump.sh/realscout/doc/realscout-api/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "RealScout API MCP server": {
    "url": "https://bump.sh/realscout/doc/realscout-api/mcp"
  }
}

Close
GET /activity

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

  • contact_id string

    Only this contact's activity; omit for the whole book. An id that is none of the agent's contacts is an empty page.

  • actions array[string]

    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, or cma_view. Default value is ["view", "save", "unsave", "hide", "unhide", "rated", "comment", "request_showing", "open_house_view", "home_report_view", "market_alert_view", "cma_view"].

  • from string(date-time)

    Only activity at or after this ISO-8601 timestamp; defaults to one year ago.

  • to string(date-time)

    Only activity at or before this ISO-8601 timestamp.

  • cursor string

    Opaque cursor from the previous page's next_cursor; a cursor another list issued is refused.

  • limit integer

    Page size, 1 to 100.

    Minimum value is 1, maximum value is 100. Default value is 25.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • X-RateLimit-Limit integer

      Calls allowed in the current window.

    • X-RateLimit-Remaining integer

      Calls left in the current window.

    • X-RateLimit-Reset integer

      Epoch seconds at which the window resets.

    Hide response attributes Show response attributes object
    • data array[object] Required
      Hide data attributes Show data attributes object
      • id string Required
      • action string | null Required
      • created_at string(date-time) | null Required
      • contact object | null Required
        Hide contact attributes Show contact attributes object | null
        • id string Required
        • realscout_url string(uri) Required
      • rating integer | null Required
      • view_count integer | null Required
      • actionable object | null Required
        Any of:
    • has_more boolean Required
    • next_cursor string | null Required

      Send as cursor for the next page; null on the last one.

  • 400 application/json

    The request is invalid; field names 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.

    Hide response attribute Show response attribute object
    • error object Required
      Hide error attributes Show error attributes object
      • code string Required

        Values are internal_error, invalid_request, missing_scope, not_found, rate_limited, or unauthorized.

      • message string Required
      • field string

        The offending input, when one input is to blame.

      • request_id string Required

        Quote this when reporting a problem; it identifies the call in our logs.

  • 401 application/json

    Invalid or missing bearer token.

    Hide response attribute Show response attribute object
    • error object Required
      Hide error attributes Show error attributes object
      • code string Required

        Values are internal_error, invalid_request, missing_scope, not_found, rate_limited, or unauthorized.

      • message string Required
      • field string

        The offending input, when one input is to blame.

      • request_id string Required

        Quote this when reporting a problem; it identifies the call in our logs.

  • 403 application/json

    The credential was not granted the scope this call requires.

    Hide response attribute Show response attribute object
    • error object Required
      Hide error attributes Show error attributes object
      • code string Required

        Values are internal_error, invalid_request, missing_scope, not_found, rate_limited, or unauthorized.

      • message string Required
      • field string

        The offending input, when one input is to blame.

      • request_id string Required

        Quote this when reporting a problem; it identifies the call in our logs.

  • 404 application/json

    Not found, or not yours: the two are indistinguishable on purpose.

    Hide response attribute Show response attribute object
    • error object Required
      Hide error attributes Show error attributes object
      • code string Required

        Values are internal_error, invalid_request, missing_scope, not_found, rate_limited, or unauthorized.

      • message string Required
      • field string

        The offending input, when one input is to blame.

      • request_id string Required

        Quote this when reporting a problem; it identifies the call in our logs.

  • 429 application/json

    Rate limit exceeded; Retry-After says when to try again.

    Hide headers attribute Show headers attribute
    • Retry-After integer

      Seconds until the budget refills.

    Hide response attribute Show response attribute object
    • error object Required
      Hide error attributes Show error attributes object
      • code string Required

        Values are internal_error, invalid_request, missing_scope, not_found, rate_limited, or unauthorized.

      • message string Required
      • field string

        The offending input, when one input is to blame.

      • request_id string Required

        Quote this when reporting a problem; it identifies the call in our logs.

  • 500 application/json

    Something went wrong on our side.

    Hide response attribute Show response attribute object
    • error object Required
      Hide error attributes Show error attributes object
      • code string Required

        Values are internal_error, invalid_request, missing_scope, not_found, rate_limited, or unauthorized.

      • message string Required
      • field string

        The offending input, when one input is to blame.

      • request_id string Required

        Quote this when reporting a problem; it identifies the call in our logs.

GET /activity
curl -H "Authorization: Bearer rs_agent_..." "https://www.realscout.com/api/agent/v1/activity?actions=view,save&limit=50"
Response examples (200)
{
  "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"
}
Response examples (400)
{
  "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"
  }
}
Response examples (401)
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing credentials.",
    "request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
  }
}
Response examples (403)
{
  "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"
  }
}
Response examples (404)
{
  "error": {
    "code": "not_found",
    "message": "No endpoint at GET /api/agent/v1/activity.",
    "request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
  }
}
Response examples (429)
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Try again in 30 seconds.",
    "request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
  }
}
Response examples (500)
{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side.",
    "request_id": "9b2f4c1e-7d3a-4e5b-8f6c-0a1d2e3f4b5c"
  }
}