Sell to State

Add a tender to a saved list. Body: id (list id) + tender_no OR award_id. Idempotent. Requires a user API key.

Create a new saved award list (personal). Body: name. Requires a user API key.

Delete a saved list (and its items). Body: id. Requires a user API key (creator or workspace owner).

Delete a saved search. Body: id. Requires a user API key (creator or workspace owner).

Export a filtered award set as CSV, at most 500 rows per call (use the REST /api/v1/awards.csv for larger files). country omitted means singapore. A bad country is an error, not a Singapore file.

All awards for one agency (by slug or display-name match).

Buyer (agency) detail by slug: summary stats, yearly spend trend, sector breakdown, and top suppliers.

Alias of get_buyer (back-compat). Buyer (agency) detail by slug: summary stats, yearly spend trend, sector breakdown, and top suppliers.

One saved list with paginated items joined to award data (description/buyer/supplier/amount/date). Requires a user API key.

List every saved award list the caller (x-api-key owner) can see. Each list has itemCount (tender items only), buyerCount, supplierCount and totalCount (all items). Requires a user API key.

The state of the first search that submit_onboarding started. Returns the same body as submit_onboarding; status generating: call again in 15 seconds.

One saved search by id (visible to the caller, else not_found). Requires a user API key.

List every saved search the caller (x-api-key owner) can see (personal + shared workspace). Requires a user API key.

Sector detail by slug: summary stats, yearly trend, and active partners (kind=buyers|suppliers).

All awards for one supplier (by display-name match).

Supplier detail by slug: summary stats, yearly awarded trend, sector breakdown, and top buyers.

Single tender (award) detail by numeric award_id OR public tender page id, with related awards (same tender / same buyer) and requirements: what a company needs to bid in the tender's country (registration, foreign companies, documents, bid and performance security, law, portal, language, e-signature, complaints, sources, guide_url; null if none). The tender documents take priority over this summary.

Top buyers (agencies) by total spend.

The curated sector taxonomy (slug + name).

Top suppliers by total awarded.

Turn a request in words into a Sell to State search: terms in the languages of the countries, and filters (scope, country, lifecycle, date window, amounts). Example text: 'body-worn cameras for police in Kenya and South Africa, open tenders'. Returns {summary, scope, q, filters, url, count, notes}; call `search` with scope, q and the filters to get the rows. When the text names nothing to search, returns {answer} only. Uses the daily AI search limit (3 a day for free accounts, 100 with a plan).

Remove a tender from a saved list. Body: id (list id) + tender_no. Requires a user API key.

Rename a saved list. Body: id, name. Requires a user API key (creator or workspace owner).

Rename a saved search. Body: id, name. Requires a user API key (creator or workspace owner).

Save a search under a name. Body: name, query (filter set), kind? ('atlas' → unified-search shape, else legacy Explorer filters). Requires a user API key.

Faceted full-text search over one collection (scope). Every filter is a property of this schema, the same params as REST GET /api/v1/search; values of a fixed list are matched in any case. A bad value or an unknown argument is an invalid-params error whose data lists every problem (errors[]). Tender hits carry lifecycle, deadline_at, accepts_bids and source_url when the source gives them. Returns {hits, found, page, per_page, facets}.

Search awarded tenders in one country (Postgres), largest amount first, stable paging. Every filter is a property of this schema; country omitted means singapore. A bad value or an unknown argument is an invalid-params error whose data lists every problem (errors[]). Returns {rows, total, page, pageSize}.

Send the answers of a new account's onboarding form (whoami gives onboarding_required and the questions). Ask the user the questions and use the answers that the user gives. Show the user all answers and get a yes. Product files are optional: send the text only of files that the user gives you for this form. Sell to State saves the profile, reads the website and the files, and builds the user's first search with a weekly email alert. Returns {status, summary, counts, rows (each with url), app_url, saved_search, next_options}; status generating: call get_onboarding_search with build_id.

Self-introspection: resolve the caller's identity + entitlement + granted scopes. Returns {subject, type, active, plan, scopes, export_cap}. Works when the account has no active plan (active:false), so an agent can check access before it calls a data tool.