Retrieve FindAll run | Scout

curl https://core.usescout.sh/v1/findall/runs/findall_id \
     -H "Authorization: Bearer <token>"

{
  "findall_id": "fa-37e97d4654d14fa6ad2fb342",
  "status": null,
  "query": "S-1 stage AI infrastructure companies",
  "entities": [
    {
      "name": "CoreWeave",
      "website": "https://coreweave.com",
      "headquarters": "Livingston, New Jersey",
      "source": "https://en.wikipedia.org/wiki/CoreWeave"
    },
    {
      "name": "Lambda",
      "website": "https://lambdalabs.com",
      "headquarters": "San Francisco, California",
      "source": "https://lambdalabs.com/about"
    }
  ],
  "count": 2,
  "credits": 7,
  "fields": [
    "name",
    "website",
    "headquarters"
  ],
  "createdAt": "2025-01-20T14:10:02+00:00",
  "completedAt": "2025-01-20T14:11:39+00:00"
}

Poll an async FindAll run; entities are included once it completes.

curl https://core.usescout.sh/v1/findall/runs/findall_id \
     -H "Authorization: Bearer <token>"

{
  "findall_id": "fa-37e97d4654d14fa6ad2fb342",
  "status": null,
  "query": "S-1 stage AI infrastructure companies",
  "entities": [
    {
      "name": "CoreWeave",
      "website": "https://coreweave.com",
      "headquarters": "Livingston, New Jersey",
      "source": "https://en.wikipedia.org/wiki/CoreWeave"
    },
    {
      "name": "Lambda",
      "website": "https://lambdalabs.com",
      "headquarters": "San Francisco, California",
      "source": "https://lambdalabs.com/about"
    }
  ],
  "count": 2,
  "credits": 7,
  "fields": [
    "name",
    "website",
    "headquarters"
  ],
  "createdAt": "2025-01-20T14:10:02+00:00",
  "completedAt": "2025-01-20T14:11:39+00:00"
}

Poll an async FindAll run; entities are included once it completes.

Authentication

AuthorizationBearer

Your API key, sent as a Bearer token.

Path parameters

findall_idstringRequired

Response

Successful Response

findall_idstring

Opaque run identifier.

statusany

String for back-compat (queued/running/completed/failed/cancelled) OR the rich Parallel-style status object when the run has completed.

querystring

The enumeration query.

entitieslist of maps from strings to any

Entities found so far (flat rows; back-compat).

countinteger

Number of entities found.

creditsinteger

Cost accumulated by the run.

fieldslist of strings or null

The requested entity fields, if any.

output_schemamap from strings to any or null

The JSON Schema for entity objects, if any.

candidateslist of maps from strings to any or null

Rich candidates once the run has completed.

metadatamap from strings to any or null

Run metadata: {title, input}.

findall_schemamap from strings to any or null

Schema spec: objective, conditions, generator.

errorstring or null

Failure reason when status is failed.

createdAtstring or null

ISO-8601 created.

completedAtstring or null

ISO-8601 finished.

Errors

422

Unprocessable Entity Error

$	curl https://core.usescout.sh/v1/findall/runs/findall_id \
>	-H "Authorization: Bearer <token>"

1	{
2	"findall_id": "fa-37e97d4654d14fa6ad2fb342",
3	"status": null,
4	"query": "S-1 stage AI infrastructure companies",
5	"entities": [
6	{
7	"name": "CoreWeave",
8	"website": "https://coreweave.com",
9	"headquarters": "Livingston, New Jersey",
10	"source": "https://en.wikipedia.org/wiki/CoreWeave"
11	},
12	{
13	"name": "Lambda",
14	"website": "https://lambdalabs.com",
15	"headquarters": "San Francisco, California",
16	"source": "https://lambdalabs.com/about"
17	}
18	],
19	"count": 2,
20	"credits": 7,
21	"fields": [
22	"name",
23	"website",
24	"headquarters"
25	],
26	"createdAt": "2025-01-20T14:10:02+00:00",
27	"completedAt": "2025-01-20T14:11:39+00:00"
28	}