### Example request for tender documents Source: https://api-docs.openprocurement.org/en/latest/tenders.html A complete example of an authenticated request to retrieve tender documents and the corresponding JSON response. ```HTTP GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0 Authorization: Basic YnJva2VyOg== Host: api-sandbox.openprocurement.org 200 OK Content-Type: application/json; charset=UTF-8 { "data": [ { "hash": "md5:00000000000000000000000000000000", "description": "document description modified", "title": "Notice.pdf", "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.044656+03:00", "author": "tender_owner", "documentType": "technicalSpecifications", "id": "8c4f7355fed4463b98eb429237a2e6a5", "dateModified": "2017-07-25T17:36:56.044677+03:00" }, { "hash": "md5:00000000000000000000000000000000", "author": "tender_owner", "title": "AwardCriteria.pdf", "url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.140078+03:00", "id": "14f948894bcc4ddc9da4d2129b028116", "dateModified": "2017-07-25T17:36:56.140097+03:00" } ] } ``` -------------------------------- ### List Tenders with GET Request Source: https://api-docs.openprocurement.org/en/latest/tutorial.html Retrieve a list of tenders to verify modifications. This GET request returns tender IDs and their last modification dates. ```http GET /api/2.3/tenders?opt_pretty=1 HTTP/1.0 Host: api-sandbox.openprocurement.org 200 OK Content-Type: application/json; charset=UTF-8 { "next_page": { "path": "/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.824208%2B03%3A00", "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-07-25T17%3A36%3A55.824208%2B03%3A00", "offset": "2017-07-25T17:36:55.824208+03:00" }, "data": [ { "id": "f3641d0ba0f042e8b49de06d5c7921af", "dateModified": "2017-07-25T17:36:55.662421+03:00" }, { "id": "f8802ccce4d9409693ae745ea983c59a", "dateModified": "2017-07-25T17:36:55.824208+03:00" } ] } ``` -------------------------------- ### Enable acceleration mode Source: https://api-docs.openprocurement.org/en/latest/acceleration.html Set these parameters to accelerate auction periods and start dates in the sandbox. ```text mode: test ``` ```text procurementMethodDetails: quick, accelerator=1440 ``` ```text submissionMethodDetails: quick ``` -------------------------------- ### List all tender documents Source: https://api-docs.openprocurement.org/en/latest/tutorial.html Use a GET request to retrieve a list of all documents associated with a tender. ```http GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0 Authorization: Basic YnJva2VyOg== Host: api-sandbox.openprocurement.org 200 OK Content-Type: application/json; charset=UTF-8 { "data": [ { "hash": "md5:00000000000000000000000000000000", "description": "document description modified", "title": "Notice.pdf", "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.044656+03:00", "author": "tender_owner", "documentType": "technicalSpecifications", "id": "8c4f7355fed4463b98eb429237a2e6a5", "dateModified": "2017-07-25T17:36:56.044677+03:00" } ``` -------------------------------- ### Tender Object Structure Source: https://api-docs.openprocurement.org/en/latest/tutorial.html Example of a tender object containing item details, value, and procuring entity information. ```json "code": "44617100-9", "name": "item" }, "quantity": 5 } ], "value": { "currency": "UAH", "amount": 500.0, "valueAddedTaxIncluded": true }, "mode": "test", "title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам", "procuringEntity": { "contactPoint": { "name": "Державне управління справами", "telephone": "0440000000" }, "identifier": { "scheme": "UA-EDR", "id": "00037256", "uri": "http://www.dus.gov.ua/" }, "name": "Державне управління справами", "kind": "general", "address": { "postalCode": "01220", "countryName": "Україна", "streetAddress": "вул. Банкова, 11, корпус 1", "region": "м. Київ", "locality": "м. Київ" } } } } ``` -------------------------------- ### Retrieve Tender Awards Source: https://api-docs.openprocurement.org/en/latest/qualification.html Example of a GET request to fetch awards for a specific tender, including details on complaints and their resolution status. ```http GET /api/2.3/tenders/6e33b56945624315afece8e75af7193c/awards HTTP/1.0 Authorization: Basic YnJva2VyOg== Host: api-sandbox.openprocurement.org 200 OK Content-Type: application/json; charset=UTF-8 { "data": [ { "status": "unsuccessful", "documents": [ { "hash": "md5:00000000000000000000000000000000", "author": "tender_owner", "title": "Unsuccessful_Reason.pdf", "url": "http://public.docs-sandbox.openprocurement.org/get/800261cb6def4a11bf3791e830befb3c?KeyID=1a1ebb61&Signature=PbVLwL3AMNy7I%2FnhEANHhLSNoOKKay2pvYsHnbBXD%252BBZM60nIqXTk3UDDN6TsctsZ2k0TtSk0XEwlEoFdbKRAQ%253D%253D", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:52.098854+03:00", "id": "0ac19aedb5d2407598d91aa963d6a027", "dateModified": "2017-07-25T17:36:52.098871+03:00" } ], "complaintPeriod": { "startDate": "2017-07-25T17:36:51.988435+03:00", "endDate": "2017-07-27T17:36:52.185900+03:00" }, "suppliers": [ { "contactPoint": { "email": "soleksuk@gmail.com", "telephone": "+380 (432) 21-69-30", "name": "Сергій Олексюк" }, "identifier": { "scheme": "UA-EDR", "id": "00137256", "uri": "http://www.sc.gov.ua/" }, "name": "ДКП «Школяр»", "address": { "postalCode": "21100", "countryName": "Україна", "streetAddress": "вул. Островського, 33", "region": "м. Вінниця", "locality": "м. Вінниця" } } ], "bid_id": "ee786a6e8a7d470196a751273f064e78", "value": { "currency": "UAH", "amount": 450.0, "valueAddedTaxIncluded": true }, "date": "2017-07-25T17:36:52.191749+03:00", "complaints": [ { "status": "resolved", "documents": [ { "hash": "md5:00000000000000000000000000000000", "author": "complaint_owner", "title": "Complaint_Attachement.pdf", "url": "http://public.docs-sandbox.openprocurement.org/get/8f6064cff50e40e98b6a0d3a5bf285f3?KeyID=1a1ebb61&Signature=GUupJVcUEjCGb8j6wOYSyvTs7P6XMvDfE%2FK1BBt82UFMqRa8qpjkQ2qziQjf8yqB5eZ5KRggHUyaUA0qhE67AQ%253D%253D", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:53.000914+03:00", "id": "96ad4bc79c704f6eb094b83bf2ca817a", "dateModified": "2017-07-25T17:36:53.000946+03:00" } ], "description": "complaint description", "author": { "contactPoint": { "email": "soleksuk@gmail.com", "telephone": "+380 (432) 21-69-30", "name": "Сергій Олексюк" }, "identifier": { "scheme": "UA-EDR", "id": "00137256", "uri": "http://www.sc.gov.ua/" }, "name": "ДКП «Школяр»", "address": { "postalCode": "21100", "countryName": "Україна", "streetAddress": "вул. Островського, 33", "region": "м. Вінниця", "locality": "м. Вінниця" } }, "resolutionType": "resolved", "type": "claim", "title": "complaint title", "satisfied": true, "tendererAction": "Виправлено неконкурентні умови", "dateAnswered": "2017-07-25T17:36:53.465653+03:00", "tendererActionDate": "2017-07-25T17:36:53.465668+03:00", "dateSubmitted": "2017-07-25T17:36:53.127004+03:00", "complaintID": "UA-2017-07-25-000001.5", "date": "2017-07-25T17:36:53.605801+03:00", "resolution": "Виправлено неконкурентні умови", "id": "fc1eef6ef50d4656b981aae8bb181467" }, { "status": "resolved", ``` -------------------------------- ### Create Tender with Additional Data Source: https://api-docs.openprocurement.org/en/latest/tutorial.html Create a tender with extended details, including features and other specific parameters. This example demonstrates a POST request with a JSON payload. ```http POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0 Authorization: Basic YnJva2VyOg== Content-Length: 4164 Content-Type: application/json Host: api-sandbox.openprocurement.org { "data": { "features": [ { "code": "OCDS-123454-AIR-INTAKE", "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)", "title": "Потужність всмоктування", "enum": [ { "value": 0.1, "title": "До 1000 Вт" }, { "value": 0.15, "title": "Більше 1000 Вт" } ], "title_en": "Air Intake", "relatedItem": "e214fbd9ed204c9bb42f9e1f628109f8", "featureOf": "item" }, { "code": "OCDS-123454-YEARS", "description": "Кількість років, які організація учасник працює на ринку", "title": "Років на ринку", "enum": [ { "value": 0.05, ``` -------------------------------- ### Enable fast-forward option Source: https://api-docs.openprocurement.org/en/latest/acceleration.html Set this value for submissionMethodDetails to skip the auction stage while still generating an auctionURL. ```text quick(mode:fast-forward) ``` -------------------------------- ### GET Request for Bids Listing Source: https://api-docs.openprocurement.org/en/latest/bidding.html Use this GET request to retrieve a list of all bids submitted for a specific tender after the auction has ended. Ensure you replace the placeholder tender ID with the actual ID. ```http GET /api/0/tenders/6f73bf0f7f734f459f7e37e3787054a0/bids HTTP/1.1 ``` -------------------------------- ### Retrieve Another Bid Participation URL Source: https://api-docs.openprocurement.org/en/latest/tutorial.html This example shows how to retrieve the participation URL for a different bid. Note the different bid ID and potentially different bid details in the response. ```http GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3?acc_token=22d01413f6604999a61b174fabe6ffe2 HTTP/1.0 Authorization: Basic YnJva2VyOg== Host: api-sandbox.openprocurement.org 200 OK Content-Type: application/json; charset=UTF-8 { "data": { "status": "active", "documents": [ { "hash": "md5:00000000000000000000000000000000", "title": "Proposal_part1.pdf", "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/df9dd9b2c3a94843872c990a919137b7?download=331460f91e944a2d83136dee00b94f0f", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.537226+03:00", "id": "df9dd9b2c3a94843872c990a919137b7", "dateModified": "2017-07-25T17:36:56.537243+03:00" }, { "hash": "md5:00000000000000000000000000000000", "title": "Proposal_part2.pdf", "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/bfa4b4a0f47f4270b5f139307e217ec3/documents/89daa7ea804c40febcbc83bed93587ea?download=3bfc49d63bd44e9488e1270003e52178", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.537686+03:00", "id": "89daa7ea804c40febcbc83bed93587ea", "dateModified": "2017-07-25T17:36:56.537703+03:00" } ], "value": { "currency": "UAH", "amount": 499.0, "valueAddedTaxIncluded": true }, "tenderers": [ { "contactPoint": { "email": "aagt@gmail.com", "telephone": "+380 (322) 91-69-30", "name": "Андрій Олексюк" }, "identifier": { "scheme": "UA-EDR", "id": "00137226", "uri": "http://www.sc.gov.ua/" }, "name": "ДКП «Книга»", "address": { "postalCode": "79013", "countryName": "Україна", "streetAddress": "вул. Островського, 34", "region": "м. Львів", "locality": "м. Львів" } } ], "date": "2017-07-25T17:36:56.536644+03:00", "id": "bfa4b4a0f47f4270b5f139307e217ec3" } } ``` -------------------------------- ### Get Active Award Source: https://api-docs.openprocurement.org/en/latest/qualification.html Retrieves details of an active award for a given tender. ```APIDOC ## GET /api/2.3/tenders/{tender_id}/awards/{award_id} ### Description Retrieves the details of a specific award for a tender. This is often used to check the status of an award before attempting to cancel it. ### Method GET ### Endpoint /api/2.3/tenders/{tender_id}/awards/{award_id} ### Parameters #### Path Parameters - **tender_id** (string) - Required - The unique identifier of the tender. - **award_id** (string) - Required - The unique identifier of the award. ### Response #### Success Response (200) - **data** (object) - Contains the award details, including status, suppliers, and value. ### Response Example ```json { "data": { "status": "active", "complaintPeriod": { "startDate": "2017-07-25T17:36:52.186270+03:00", "endDate": "2017-07-27T17:36:52.318837+03:00" }, "suppliers": [ { "contactPoint": { "name": "Державне управління справами", "telephone": "0440000000" }, "identifier": { "scheme": "UA-EDR", "id": "00037256", "uri": "http://www.dus.gov.ua/" }, "name": "Державне управління справами", "address": { "postalCode": "01220", "countryName": "Україна", "streetAddress": "вул. Банкова, 11, корпус 1", "region": "м. Київ", "locality": "м. Київ" } } ], "bid_id": "39481e7f97894915832b3b882afdade4", "value": { "currency": "UAH", "amount": 469.0, "valueAddedTaxIncluded": true }, "date": "2017-07-25T17:36:52.324371+03:00", "id": "4983c533470d473aa5769ba399849cb0" } } ``` ``` -------------------------------- ### Explore Tenders Endpoint Source: https://api-docs.openprocurement.org/en/latest/tutorial.html Retrieves the list of tenders from the API using a GET request. ```http GET /api/2.3/tenders HTTP/1.0 Authorization: Basic YnJva2VyOg== Host: api-sandbox.openprocurement.org 200 OK Content-Type: application/json; charset=UTF-8 { "next_page": { "path": "/api/2.3/tenders?offset=", "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=", "offset": "" }, "data": [] } ``` -------------------------------- ### PATCH Request with Access Token as URL Parameter Source: https://api-docs.openprocurement.org/en/latest/authentication.html This example shows how to make a PATCH request to the API, including an access token in the URL query string. Ensure the token is valid and associated with the correct tender. ```http PATCH /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af?acc_token=2ef61fa89e8a451ba4149d2f8e31173b HTTP/1.0 Authorization: Basic YnJva2VyOg== Content-Length: 75 Content-Type: application/json Host: api-sandbox.openprocurement.org { "data": { "tenderPeriod": { "endDate": "2017-08-09T17:37:05.888957+03:00" } } } 200 OK Content-Type: application/json; charset=UTF-8 { "data": { "procurementMethod": "open", "status": "active.enquiries", "awardCriteria": "lowestCost", "tenderPeriod": { "startDate": "2017-08-01T17:36:49.306344+03:00", "endDate": "2017-08-09T17:37:05.888957+03:00" }, "title": "футляри до державних нагород", "minimalStep": { "currency": "UAH", "amount": 35.0, "valueAddedTaxIncluded": true }, "items": [ { "description": "футляри до державних нагород", "classification": { "scheme": "ДК021", "description": "Cartons", "id": "44617100-9" }, "additionalClassifications": [ { "scheme": "ДКПП", "id": "17.21.1", "description": "папір і картон гофровані, паперова й картонна тара" } ], "deliveryAddress": { "postalCode": "79000", "countryName": "Україна", "streetAddress": "вул. Банкова 1", "region": "м. Київ", "locality": "м. Київ" }, "deliveryDate": { "startDate": "2017-07-27T17:36:49.306344+03:00", "endDate": "2017-07-30T17:36:49.306344+03:00" }, "id": "4ee2b0431a064e0eb155eeb650bdfdd0", "unit": { "code": "44617100-9", "name": "item" }, "quantity": 5 } ], "procurementMethodType": "belowThreshold", "value": { "currency": "UAH", "amount": 500.0, "valueAddedTaxIncluded": true }, "submissionMethod": "electronicAuction", "date": "2017-07-25T17:36:55.659566+03:00", "next_check": "2017-08-01T17:36:49.306344+03:00", "procuringEntity": { "contactPoint": { "name": "Державне управління справами", "telephone": "0440000000" }, "identifier": { "scheme": "UA-EDR", "id": "00037256", "uri": "http://www.dus.gov.ua/" }, "name": "Державне управління справами", "kind": "general", "address": { "postalCode": "01220", "countryName": "Україна", "streetAddress": "вул. Банкова, 11, корпус 1", "region": "м. Київ", "locality": "м. Київ" } }, "enquiryPeriod": { "startDate": "2017-07-25T17:36:55.659520+03:00", "endDate": "2017-08-01T17:36:49.306344+03:00" }, "owner": "broker", "dateModified": "2017-07-25T17:36:55.921421+03:00", "id": "f3641d0ba0f042e8b49de06d5c7921af", "tenderID": "UA-2017-07-25-000001" } } ``` -------------------------------- ### GET /tenders/{id}/documents Source: https://api-docs.openprocurement.org/en/latest/tenders.html Retrieves a list of documents associated with a specific tender. ```APIDOC ## GET /tenders/{id}/documents ### Description Retrieves a list of documents linked to a specific tender. ### Method GET ### Endpoint /tenders/{id}/documents ### Parameters #### Path Parameters - **id** (string) - Required - The unique identifier of the tender. ### Response #### Success Response (200) - **data** (array) - List of document objects containing metadata such as hash, title, format, and download URL. ``` -------------------------------- ### Upload Proposal Document Source: https://api-docs.openprocurement.org/en/latest/tutorial.html Use this POST request to upload a proposal document for a bid. Ensure you have the bid's access token and provide a valid URL, title, hash, and format for the document. ```http POST /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents?acc_token=1570f17a0a084e29aad2dc9a600e5589 HTTP/1.0 Authorization: Basic YnJva2VyOg== Content-Length: 332 Content-Type: application/json Host: api-sandbox.openprocurement.org { "data": { "url": "http://public.docs-sandbox.openprocurement.org/get/9dbee8d173ea4ce0a507c196ee39bf54?KeyID=459f8ecf&Signature=rZYCyINjYNoMJTwUJ1IQ8jTR%2FXiOIAnsLI2fN%2BsEtG8mxyoYq3RiXCYmE%2BZIsQWV4W6gszc8aC2s7lhV%2FxerBw%3D%3D", "title": "Proposal.pdf", "hash": "md5:00000000000000000000000000000000", "format": "application/pdf" } } 201 Created Content-Type: application/json; charset=UTF-8 Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27 { "data": { "hash": "md5:00000000000000000000000000000000", "title": "Proposal.pdf", "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/bids/ba18d19f2a3948deb997a7a55dd2f194/documents/2d439b94c3de42e28bb10c9d9576fd27?download=9dbee8d173ea4ce0a507c196ee39bf54", "format": "application/pdf", "documentOf": "tender", "datePublished": "2017-07-25T17:36:56.467858+03:00", "id": "2d439b94c3de42e28bb10c9d9576fd27", "dateModified": "2017-07-25T17:36:56.467877+03:00" } } ``` -------------------------------- ### GET /tenders/{id} Source: https://api-docs.openprocurement.org/en/latest/tenders.html Retrieves detailed information for a specific tender by its unique identifier. ```APIDOC ## GET /tenders/{id} ### Description Retrieves the full information for an individual tender. ### Method GET ### Endpoint /tenders/{id} ### Parameters #### Path Parameters - **id** (string) - Required - The unique identifier of the tender. ``` -------------------------------- ### Register a bid proposal Source: https://api-docs.openprocurement.org/en/latest/bidding.html Submit a POST request to create a new bid for a specific tender. ```http POST /tenders/64e93250be76435397e8c992ed4214d1/bids/ HTTP/1.1 ``` ```http HTTP/1.1 201 Created Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/4879d3f8ee2443169b5fbbc9f89fa607 ```