Findall Run List | Scout

curl -G https://core.usescout.sh/v1/findall/runs \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d limit=5 \
     -d offset=0

{
  "runs": [
    {
      "id": "fa3b9e2d-7c4a-4f9a-9d2e-1a2b3c4d5e6f",
      "name": "Product Launch Monitoring",
      "status": "completed",
      "createdAt": "2024-06-10T15:22:30Z",
      "completedAt": "2024-06-10T16:45:00Z",
      "resultsCount": 1240
    },
    {
      "id": "b7d8f9a0-3c2e-4d1f-8a9b-0c1d2e3f4a5b",
      "name": "Competitor Brand Mentions",
      "status": "running",
      "createdAt": "2024-06-11T09:10:05Z",
      "resultsCount": 560
    },
    {
      "id": "c1d2e3f4-a5b6-7c8d-9e0f-1a2b3c4d5e6f",
      "name": "Market Trend Analysis",
      "status": "failed",
      "createdAt": "2024-06-09T12:00:00Z",
      "error": "Timeout while fetching data"
    }
  ],
  "total": 3,
  "limit": 5,
  "offset": 0
}

Paginated list of FindAll runs, newest first.

Authentication

AuthorizationBearer

Your API key, sent as a Bearer token.

Query parameters

limitintegerOptionalDefaults to 5

offsetintegerOptionalDefaults to 0

Response

Successful Response

Errors

422

Unprocessable Entity Error

$	curl -G https://core.usescout.sh/v1/findall/runs \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d limit=5 \
>	-d offset=0

1	{
2	"runs": [
3	{
4	"id": "fa3b9e2d-7c4a-4f9a-9d2e-1a2b3c4d5e6f",
5	"name": "Product Launch Monitoring",
6	"status": "completed",
7	"createdAt": "2024-06-10T15:22:30Z",
8	"completedAt": "2024-06-10T16:45:00Z",
9	"resultsCount": 1240
10	},
11	{
12	"id": "b7d8f9a0-3c2e-4d1f-8a9b-0c1d2e3f4a5b",
13	"name": "Competitor Brand Mentions",
14	"status": "running",
15	"createdAt": "2024-06-11T09:10:05Z",
16	"resultsCount": 560
17	},
18	{
19	"id": "c1d2e3f4-a5b6-7c8d-9e0f-1a2b3c4d5e6f",
20	"name": "Market Trend Analysis",
21	"status": "failed",
22	"createdAt": "2024-06-09T12:00:00Z",
23	"error": "Timeout while fetching data"
24	}
25	],
26	"total": 3,
27	"limit": 5,
28	"offset": 0
29	}