Notices

Get a notice by id

Fetch a single notice, including its lots and any awarded contracts. The id is the same identifier returned by notice search and by the buyer_id/supplier_id filters.

get/v1/notices/{id}

Request

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

Path parameters

idstring uuid required

The notice's unique identifier.

Response

The notice.

idstring uuid required

The notice's unique identifier.

titlestring required

The notice's title.

descriptionstring required

The notice's description.

country_codestring required

ISO 3166-1 alpha-2 country code the notice relates to.

stage'pipeline' | 'pre_tender' | 'stale_pre_tender' | 'canceled_pre_tender' | 'open_tender' | 'closed_tender' | 'canceled_tender' | 'unknown_tender' | 'awarded_contract' | 'expired_contract' | 'canceled_award' required

The notice's procurement stage.

source_urlstring required

URL of the notice on the original source.

publish_datestring date required

Date this notice was published (its phase's release date).

close_datestring date nullable required

Bid submission deadline (tender close). Indicative on pre-tender notices; null on award/contract notices (the deadline is on the sibling tender notice).

award_datestring date nullable required

Date the contract was awarded. Best-effort (may fall back to contract start); earliest across awards. Null before award.

expiry_datestring date nullable required

Earliest expected contract end date. Excludes extensions/options, so it is the earliest — not latest — end. Null when not applicable or unknown.

Changes

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