Notices

Search notices by keyword

Search and filter procurement notices. Every parameter is optional, so filters can stand alone without a keyword. Results are ranked by relevance unless sort is set, and paginated with next_cursor.

get/v1/notices/search

Request

  • Base URL: https://api.stotles.com
  • URL: https://api.stotles.com/v1/notices/search
  • Auth: API key in header x-api-key

Query parameters

querystring[]

Free-text keyword search over the notice (each 2–500 characters). Repeatable; multiple values are combined per query_operator.

query_operator'and' | 'or'

How multiple query keywords combine: match all (and) or any (or). Default or.

country_codestring[]

Filter to notices in these ISO 3166-1 alpha-2 countries. Repeatable.

cpv_codestring[]

Filter to notices classified under these CPV codes. Repeatable.

buyer_idstring[]

Filter to notices involving these buyers (by id). Repeatable.

supplier_idstring[]

Filter to notices awarded to these suppliers (by id). Repeatable.

stagestring[]

Filter to notices in these stages. Repeatable.

framework_idstring[]

Filter to notices related to these frameworks (by id) — a framework agreement or a call-off against it. Repeatable.

framework_activity'only_framework_agreements' | 'only_call_offs' | 'exclude_framework_agreements' | 'exclude_all'

Narrow by framework relationship (agreement vs call-off).

publish_date_gtestring date

Only notices published on or after this date (inclusive).

publish_date_ltestring date

Only notices published on or before this date (inclusive).

close_date_gtestring date

Only notices whose tender close date is on or after this date (inclusive).

close_date_ltestring date

Only notices whose tender close date is on or before this date (inclusive).

expiry_date_gtestring date

Only notices whose contract expiry date is on or after this date (inclusive).

expiry_date_ltestring date

Only notices whose contract expiry date is on or before this date (inclusive).

award_date_gtestring date

Only notices whose award date is on or after this date (inclusive).

award_date_ltestring date

Only notices whose award date is on or before this date (inclusive).

value_gtenumber

Only notices whose estimated value is greater than or equal to this amount, in the notice's own currency (values are not currency-normalized). Excludes notices with no value.

value_ltenumber

Only notices whose estimated value is less than or equal to this amount, in the notice's own currency (values are not currency-normalized). Excludes notices with no value.

sort'publish_date' | 'close_date' | 'award_date' | 'expiry_date' | 'value'

Sort field. Omitted = relevance ranking. For date sorts (close/award/expiry, often null), notices missing that date sort last in both directions.

order'asc' | 'desc'

Sort direction (default desc). Applies when sort is set.

limitinteger

Maximum results per page (1–50, default 20). Ignored when cursor is set.

cursorstring

Opaque pagination cursor from a previous response's next_cursor. Carries the page and page size, so limit is ignored when it is present.

Response

A page of matching notices.

next_cursorstring nullable required

Opaque cursor for the next page of results; null when this is the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.