List SoftSolz research runs
List research runs that SoftSolz itself performed from the dashboard (these spend SoftSolz AI credits; the API cannot start one). Use it to see what has already been researched before you research it yourself.
GET
https://app.softsolz.uk/api/v1/services/my-leads/runsRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Headers
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Query Params
statusstringFilter by status (queued|running|completed|failed|cancelled).
modestringdocument, leads or businesses.
limitintegerPage size, 1-200 (default 50).
offsetintegerRows to skip.
Response
Response Body · array of objects
idintegerRun id.titlestringWhat was researched.modestringdocument is a written report; leads and businesses produce lead records.statusstringRun lifecycle.total_countintegerCompanies found to research.processed_countintegerCompanies researched so far.credits_usednumberSoftSolz AI credits the run spent.cancel_requested_atstring | nullSet once a cancel was requested.error_messagestring | nullWhy the run failed, if it did.created_atstringWhen it started.updated_atstringLast progress update.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/my-leads/runs \ --header 'Authorization: Bearer sk_live_your_key'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": [ { "id": 12, "title": "Bakeries in Manchester", "mode": "businesses", "status": "completed", "total_count": 10, "processed_count": 10, "credits_used": 1200, "cancel_requested_at": null, "error_message": null, "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-09-01T09:10:00.000Z" } ], "meta": { "limit": 50, "offset": 0, "total": 1, "has_more": false }}