{"tool":"tenders-supplier","title":"TenderGraph Supplier History","what":"Award history of a supplier from TED result notices that name it as a winner: total award notices, a dated timeline of the most recent awards with buyer, country, CPV and values as published, buyers and countries served, CPV divisions, values per currency and name variants. Only explicit award results count; no reputation or risk judgement is made.","endpoint":"https://yruz.one/api/tenders/supplier","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.015"},"params":[{"name":"name","required":true,"description":"supplier name or part of it, e.g. Siemens","example":"Siemens"},{"name":"country","required":false,"description":"buyer country, ISO code","example":"PL"},{"name":"from","required":false,"description":"published from YYYY-MM-DD","example":null},{"name":"lang","required":false,"description":"language, 2 letters (default en)","example":null}],"valid_request":{"get":"https://yruz.one/api/tenders/supplier?name=Siemens&country=PL","post":{"url":"https://yruz.one/api/tenders/supplier","body":{"name":"Siemens","country":"PL"}}},"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":{"query":{"name_contains":"string","buyer_country":"string","from":"null"},"award_notices_total":"number","name_variants":{"Siemens Healthcare Sp. z o.o.":"number","Siemens Healthcare Sp. z o. o.":"number","SIEMENS HEALTHCARE SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ":"number","SIEMENS HEALTHCARE Sp. z o.o.":"number","SIEMENS MOBILITY Sp. z o.o.":"number","Siemens Healthcare Sp. z o. o":"number","Siemens Healthcare Sp.z o.o.":"number","Siemens Energy Sp. z o.o.":"number","Siemens Sp. z o.o.":"number","Siemens Healthcare sp. z o. o.":"number","Siemens Healthcare Sp. z o.o":"number","Siemens healthcare Sp. z o. o.":"number","Siemens sp. z o.o.":"number","SIEMENS HEALTHCARE Sp. z o. o.":"number","Siemens Digital Industries":"number"},"sample":{"size":"number","published":{"from":"string","to":"string"},"buyers":{"SZPITAL UNIWERSYTECKI W KRAKOWIE":"number","Górnośląskie Centrum Medyczne im. prof. Leszka Gieca Śląskiego Uniwersytetu Medycznego w Katowicach":"number","Uniwersytecki Szpital Kliniczny nr 4 w Lublinie":"number","Szpitale Zachodniopomorskie Samodzielny Publiczny Zakład Opieki Zdrowotnej":"number","Uniwersyteckie Centrum Kliniczne":"number","Metro Warszawskie Sp. z o.o.":"number","Samodzielny Publiczny Zespół Zakładów Lecznictwa Otwartego Warszawa Żoliborz-Bielany":"number","Wojewódzki Szpital Zespolony w Kielcach":"number","Szpital Grochowski im. dr med. Rafała Masztaka spółka z ograniczoną odpowiedzialnością":"number","Śląskie Centrum Chorób Serca w Zabrzu":"number"},"buyer_countries":{"POL":"number"},"cpv_divisions":{"33000000":"number","50000000":"number","48000000":"number","38000000":"number","72000000":"number","30000000":"number","45000000":"number","32000000":"number","34000000":"number","71000000":"number"},"award_values":{"by_currency":["…"],"notices_without_value":"number","value_field":"string","conversion":"string"}},"timeline":[{"published_on":"string","notice":"string","title":"string","buyer":{"…":"…"},"cpv":["…"],"matched_winner_names":["…"],"co_winners":"number","total_value":["…"],"url":"string"}],"note":"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":["string"],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"number"}},"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"}}