{"tool":"tenders-history","title":"TenderGraph Notice History","what":"The lifecycle of a procurement procedure from one of its notices: every TED notice of the same procedure in order (prior information, call, corrigenda, award, contract modification), the change events between them (deadline changed, estimated value changed, lots changed, change reasons as published, award published, closed without award) and the resulting state. Each event references the notice that supports it; history before eForms (2023) may hold only one notice.","endpoint":"https://yruz.one/api/tenders/history","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.01"},"params":[{"name":"id","required":true,"description":"TED publication number of any notice of the procedure","example":"599727-2026"},{"name":"lang","required":false,"description":"language, 2 letters (default en)","example":null}],"valid_request":{"get":"https://yruz.one/api/tenders/history?id=599727-2026","post":{"url":"https://yruz.one/api/tenders/history","body":{"id":"599727-2026"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"product":"string","task":"string","task_version":"number","api_version":"string","data":{"procedure_id":"string","requested_notice":"string","state":"string","states":"string","notices":[{"id":"string","source":"string","source_record_id":"string","notice_type":"string","form_type":"string","stage":"string","published_on":"string","title":"string","buyer":{"…":"…"},"cpv":["…"],"contract_nature":["…"],"procedure_type":"string","procedure_id":"string","place_of_performance":["…"],"estimated_value":{"…":"…"},"lot_deadlines":["…"],"links":{"…":"…"},"notice_identifier":"string","notice_version":"number","dispatched_on":"string","official_language":["…"],"procedure_title":"string","description":"string","buyer_identifiers":["…"],"buyer_website":"string","lots":["…"],"submission_urls":["…"],"legal_basis":["…"]}],"events":[{"event":"string","notice":"string","published_on":"string","url":"string"}]},"provenance":[{"source":"string","name":"string","source_url":"string","record_urls":["string"],"retrieved_at":"string","retrieved_until":"string","served_from_cache":"boolean","licence":"string","attribution":"string"}],"data_as_of":"string","freshness_status":"string","coverage":"string","partial":"boolean","warnings":[],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"number"},"history":{"kind":"string","note":"string","system_observed":[]}},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"},"related":{"tools":[{"tool":"tenders-search","url":"https://yruz.one/api/tenders/search","why":"find EU tenders","usd":"0.005","how":"https://yruz.one/api/instructions?tool=tenders-search"},{"tool":"tenders-deadlines","url":"https://yruz.one/api/tenders/deadlines","why":"calls closing soon","usd":"0.003","how":"https://yruz.one/api/instructions?tool=tenders-deadlines"},{"tool":"tenders-awards","url":"https://yruz.one/api/tenders/awards","why":"awarded value per currency","usd":"0.02","how":"https://yruz.one/api/instructions?tool=tenders-awards"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"}}