Skip to main content
GET
List Economic Intelligence

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-10-15-1"

Query Parameters

account_id
string

Account ID, prefixed biz_. Defaults to the API key's own account; omit for personal onboarding, where signed-out visitors receive a business-setup template and eligible users receive their saved setup recommendation.

status
enum<string>

Filter recommendations by their current status.

Available options:
queued,
pending,
ready,
running,
executed,
incomplete,
superseded
input
string

What you want recommendations for, in your own words. Up to 1000 characters. Narrows the list to the recommendations that address it. Without a status filter, when none do and you can update the account, new recommendations start generating for your input, and the list shows that request until they're ready. Repeating the same input while it generates doesn't start another.

Maximum string length: 1000
has_run
boolean

When true, only recommendations someone has started running, by any user. Without account_id, covers every account you can read that has Economic Intelligence. Can't be combined with input.

order
enum<string>
default:created_at

Sort field.

Available options:
created_at,
run_started_at
direction
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
first
integer
default:20

Number of results to return from the start of the range.

Required range: x <= 100
after
string

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

last
integer

Number of results to return from the end of the range.

Required range: x <= 100
before
string

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

recommendations listed

data
object[]
required
page_info
object
required