Tutorial

Exploring basic rules

Let’s try exploring the /tenders endpoint:

GET /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=",
    "offset": ""
  },
  "data": []
}

Just invoking it reveals empty set.

Now let’s attempt creating some tender:

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
data

Response: 415 Unsupported Media Type
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']",
      "location": "header",
      "name": "Content-Type"
    }
  ]
}

Error states that the only accepted Content-Type is application/json.

Let’s satisfy the Content-type requirement:

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 4
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
data

Response: 422 Unprocessable Entity
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "No JSON object could be decoded",
      "location": "body",
      "name": "data"
    }
  ]
}

Error states that no data has been found in JSON body.

Creating tender

Let’s create tender with the minimal (only required) data set:

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 2818
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "футляри до державних нагород",
    "lots": [
      {
        "title": "Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "Опис Лот №1"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "New Cartons"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/c4b851839b51462fbf72e030424fca88
{
  "access": {
    "transfer": "c327b6d901f74ed9b327a8e292394b19",
    "token": "e433ffb60bd04399ba2a3ef727bf1792"
  },
  "data": {
    "status": "draft",
    "procurementMethod": "selective",
    "tenderID": "UA-2019-10-25-000001",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "date": "2019-10-25T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "date": "2019-10-25T01:00:00+03:00",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "dateModified": "2019-10-25T01:00:00+03:00",
    "id": "c4b851839b51462fbf72e030424fca88",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    }
  }
}

Success! Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Pay attention to the procurementMethodType. Note that tender is created with draft status.

Let’s access the URL of the created object (the Location header of the response):

GET /api/2.5/tenders/c4b851839b51462fbf72e030424fca88 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "draft",
    "procurementMethod": "selective",
    "tenderID": "UA-2019-10-25-000001",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "date": "2019-10-25T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "date": "2019-10-25T01:00:00+03:00",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "dateModified": "2019-10-25T01:00:00+03:00",
    "id": "c4b851839b51462fbf72e030424fca88",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    }
  }
}

We can see the same response we got after creating tender.

We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.

The previous tender contained only required fields. Let’s try creating tender with more data (tender has status created):

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3032
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "services",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "title": "Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "Опис Лот №1"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "21931e47b924425cba629f01ff15f044",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "mode": "test",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "title_ru": "футляры к государственным наградам",
    "title_en": "Cases with state awards",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/bb5d83ccdd124232987d417d1966bbff
{
  "access": {
    "transfer": "b96177a00aeb4fb0827989272da143fe",
    "token": "f93cb6502e344f4cbb7e7389870287af"
  },
  "data": {
    "status": "draft",
    "procurementMethod": "selective",
    "tenderID": "UA-2019-10-25-000002",
    "title": "[ТЕСТУВАННЯ] футляри до державних нагород",
    "lots": [
      {
        "date": "2019-10-25T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "description_ru": "футляры к государственным наградам",
        "id": "21931e47b924425cba629f01ff15f044",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "title_en": "[TESTING] Cases with state awards",
    "submissionMethod": "electronicAuction",
    "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": "м. Київ"
      }
    },
    "date": "2019-10-25T01:00:00+03:00",
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "awardCriteria": "lowestCost",
    "title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
    "owner": "broker",
    "dateModified": "2019-10-25T01:00:00+03:00",
    "mode": "test",
    "id": "bb5d83ccdd124232987d417d1966bbff",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ]
  }
}

And again we have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.

To move forward, you need to change status of procedure to draft.pending. This will let the bot to pull up Agreement in cfaua and move tender to the next status. If provided information meets all the requirements, than the bot moves procedure to active.enquiries status, else to draft.unsuccessful terminal status.

PATCH /api/2.5/tenders/c4b851839b51462fbf72e030424fca88?acc_token=e433ffb60bd04399ba2a3ef727bf1792 HTTP/1.0
Authorization: Bearer broker
Content-Length: 37
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft.pending"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "draft.pending",
    "procurementMethod": "selective",
    "tenderID": "UA-2019-10-25-000001",
    "title": "футляри до державних нагород",
    "lots": [
      {
        "date": "2019-10-25T01:00:00+03:00",
        "status": "active",
        "title": "Лот №1",
        "description": "Опис Лот №1",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "submissionMethod": "electronicAuction",
    "date": "2019-10-25T01:00:00+03:00",
    "agreements": [
      {
        "id": "106468013e6f47398b6f2f4da3bdeba6"
      }
    ],
    "awardCriteria": "lowestCost",
    "owner": "broker",
    "dateModified": "2019-10-25T01:00:00+03:00",
    "id": "c4b851839b51462fbf72e030424fca88",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    }
  }
}

Let’s see, that our tender meets all the requirements, the bot pulled up Agreement in cfaua of tender and changed status to active.enquiries.

GET /api/2.5/tenders/c4b851839b51462fbf72e030424fca88 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active.enquiries",
    "procurementMethod": "selective",
    "tenderID": "UA-2019-10-25-000001",
    "tenderPeriod": {
      "startDate": "2019-10-26T01:00:00+03:00",
      "endDate": "2019-10-29T01:00:00+03:00"
    },
    "title": "футляри до державних нагород",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "minimalStep": {
          "currency": "UAH",
          "amount": 2.5,
          "valueAddedTaxIncluded": true
        },
        "value": {
          "currency": "UAH",
          "amount": 500.56,
          "valueAddedTaxIncluded": true
        },
        "date": "2019-10-25T01:00:00+03:00",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "value": {
      "currency": "UAH",
      "amount": 500.56,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2019-10-25T01:00:00+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 2.5,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:00+03:00",
    "next_check": "2019-10-26T01:00:00+03:00",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2019-10-26T01:00:00+03:00"
    },
    "owner": "broker",
    "agreements": [
      {
        "agreementID": "UA-2018-09-11-000002-1",
        "status": "active",
        "features": [
          {
            "code": "OCDS-123454-AIR-INTAKE",
            "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
            "title": "Потужність всмоктування",
            "enum": [
              {
                "value": 0.1,
                "title": "До 1000 Вт"
              },
              {
                "value": 0.15,
                "title": "Більше 1000 Вт"
              }
            ],
            "title_en": "Air Intake",
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "featureOf": "item"
          },
          {
            "code": "OCDS-123454-YEARS",
            "description": "Кількість років, які організація учасник працює на ринку",
            "title": "Років на ринку",
            "enum": [
              {
                "value": 0.05,
                "title": "До 3 років"
              },
              {
                "value": 0.1,
                "title": "Більше 3 років, менше 5 років"
              },
              {
                "value": 0.15,
                "title": "Більше 5 років"
              }
            ],
            "title_en": "Years trading",
            "featureOf": "tenderer"
          }
        ],
        "title": "[ТЕСТУВАННЯ] ",
        "contracts": [
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "large",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037256",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "0a292b6466274139ad3d973fd64830ff",
            "date": "2018-07-30T17:40:15.471158+03:00",
            "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
            "id": "d6cd8c3188d74e1481a9cebb57fd9329"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037257",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.56,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "unsuccessful",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами 1",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами 1",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037251",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.56,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037258",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 500.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "fc02090c338a477f8013156a4fa2da10",
            "date": "2018-07-30T17:40:15.471264+03:00",
            "awardID": "a915a07f7f0b4dafa583cce119bf1823",
            "id": "d925d6c6124447d581f2ae5f52ba710f"
          }
        ],
        "items": [
          {
            "description": "футляри до державних нагород",
            "classification": {
              "scheme": "ДК021",
              "description": "Cartons",
              "id": "44617100-9"
            },
            "description_en": "Cases for state awards",
            "additionalClassifications": [
              {
                "scheme": "ДКПП",
                "id": "17.21.1",
                "description": "папір і картон гофровані, паперова й картонна тара"
              }
            ],
            "deliveryAddress": {
              "postalCode": "79000",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "deliveryDate": {
              "startDate": "2018-06-27T13:39:09.362837+03:00",
              "endDate": "2018-06-30T13:39:09.362837+03:00"
            },
            "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "unit": {
              "code": "44617100-9",
              "name": "item"
            },
            "quantity": 5.0
          }
        ],
        "title_en": "[TESTING] ",
        "period": {
          "startDate": "2018-09-11T11:23:20.418390+03:00",
          "endDate": "2022-01-23T11:23:20.418436+03:00"
        },
        "dateSigned": "2018-09-11T11:23:23.220310+03:00",
        "id": "106468013e6f47398b6f2f4da3bdeba6",
        "procuringEntity": {
          "kind": "general",
          "name": "Шевченківська районна в місті Києві державна адміністрація",
          "address": {
            "postalCode": "01030",
            "countryName": "Україна",
            "streetAddress": "Богдана Хмельницького вулиця, 21-29",
            "region": "Київська область",
            "locality": "Переяслав-Хмельницький"
          },
          "contactPoint": {
            "name": "Ліповець Євген Іванович",
            "url": "http://www.shev.gov.ua/",
            "telephone": "2341170",
            "faxNumber": "2343591",
            "name_en": "Gregory Gillespie",
            "email": "buh510@ukr.net",
            "availableLanguage": "en"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\"",
            "id": "00037256",
            "legalName": "Шевченківська районна в місті Києві державна адміністрація"
          },
          "name_en": "Angelica Davis"
        },
        "numberOfContracts": 3,
        "mode": "test",
        "title_ru": "[ТЕСТИРОВАНИЕ] ",
        "owner": "broker",
        "dateModified": "2018-09-17T16:26:31.372995+03:00",
        "tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32"
      }
    ],
    "id": "c4b851839b51462fbf72e030424fca88",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ]
  }
}

Let’s see what listing of tenders reveals us:

GET /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "offset": "2019-10-25T01:00:00+03:00"
  },
  "data": [
    {
      "id": "c4b851839b51462fbf72e030424fca88",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}
When you create a procedure (draft status), you can fill in the following fields:
  • in Agreement in cfaua - id
  • in Tender - title, title_en, description, description_en, guarantee, procurementMethodType, procuringEntity
  • in Lot - title, title_en, description, description_en, id, guarantee
  • in Item - description, quantity, relatedLot, unit, description_en, classification, additionalClassifications, deliveryAddress, deliveryDate, deliveryLocation, id

The only field can be modified is Tender: status.

Modifying tender

Let’s update tender by supplementing it with all other essential properties:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 96
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "quantity": 6
      }
    ],
    "tenderPeriod": {
      "endDate": "2019-11-09T01:00:10+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active.enquiries",
    "procurementMethod": "selective",
    "tenderID": "UA-2019-10-25-000004",
    "tenderPeriod": {
      "startDate": "2019-10-26T01:00:00+03:00",
      "endDate": "2019-11-09T01:00:10+03:00"
    },
    "title": "футляри до державних нагород",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "minimalStep": {
          "currency": "UAH",
          "amount": 2.5,
          "valueAddedTaxIncluded": true
        },
        "value": {
          "currency": "UAH",
          "amount": 600.67,
          "valueAddedTaxIncluded": true
        },
        "date": "2019-10-25T01:00:00+03:00",
        "id": "1b75c06ee58f4909a4201255b4ba5831"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "value": {
      "currency": "UAH",
      "amount": 600.67,
      "valueAddedTaxIncluded": true
    },
    "submissionMethod": "electronicAuction",
    "date": "2019-10-25T01:00:00+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 2.5,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:00+03:00",
    "next_check": "2019-10-26T01:00:00+03:00",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "awardCriteria": "lowestCost",
    "enquiryPeriod": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2019-10-26T01:00:00+03:00"
    },
    "owner": "broker",
    "agreements": [
      {
        "agreementID": "UA-2018-09-11-000002-1",
        "status": "active",
        "features": [
          {
            "code": "OCDS-123454-AIR-INTAKE",
            "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
            "title": "Потужність всмоктування",
            "enum": [
              {
                "value": 0.1,
                "title": "До 1000 Вт"
              },
              {
                "value": 0.15,
                "title": "Більше 1000 Вт"
              }
            ],
            "title_en": "Air Intake",
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "featureOf": "item"
          },
          {
            "code": "OCDS-123454-YEARS",
            "description": "Кількість років, які організація учасник працює на ринку",
            "title": "Років на ринку",
            "enum": [
              {
                "value": 0.05,
                "title": "До 3 років"
              },
              {
                "value": 0.1,
                "title": "Більше 3 років, менше 5 років"
              },
              {
                "value": 0.15,
                "title": "Більше 5 років"
              }
            ],
            "title_en": "Years trading",
            "featureOf": "tenderer"
          }
        ],
        "title": "[ТЕСТУВАННЯ] ",
        "contracts": [
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "large",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037256",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "0a292b6466274139ad3d973fd64830ff",
            "date": "2018-07-30T17:40:15.471158+03:00",
            "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
            "id": "d6cd8c3188d74e1481a9cebb57fd9329"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037257",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.67,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "unsuccessful",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами 1",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами 1",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037251",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.67,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037258",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "fc02090c338a477f8013156a4fa2da10",
            "date": "2018-07-30T17:40:15.471264+03:00",
            "awardID": "a915a07f7f0b4dafa583cce119bf1823",
            "id": "d925d6c6124447d581f2ae5f52ba710f"
          }
        ],
        "items": [
          {
            "description": "футляри до державних нагород",
            "classification": {
              "scheme": "ДК021",
              "description": "Cartons",
              "id": "44617100-9"
            },
            "description_en": "Cases for state awards",
            "additionalClassifications": [
              {
                "scheme": "ДКПП",
                "id": "17.21.1",
                "description": "папір і картон гофровані, паперова й картонна тара"
              }
            ],
            "deliveryAddress": {
              "postalCode": "79000",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "deliveryDate": {
              "startDate": "2018-06-27T13:39:09.362837+03:00",
              "endDate": "2018-06-30T13:39:09.362837+03:00"
            },
            "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "unit": {
              "code": "44617100-9",
              "name": "item"
            },
            "quantity": 5.0
          }
        ],
        "title_en": "[TESTING] ",
        "period": {
          "startDate": "2018-09-11T11:23:20.418390+03:00",
          "endDate": "2022-01-23T11:23:20.418436+03:00"
        },
        "dateSigned": "2018-09-11T11:23:23.220310+03:00",
        "id": "106468013e6f47398b6f2f4da3bdeba6",
        "procuringEntity": {
          "kind": "general",
          "name": "Шевченківська районна в місті Києві державна адміністрація",
          "address": {
            "postalCode": "01030",
            "countryName": "Україна",
            "streetAddress": "Богдана Хмельницького вулиця, 21-29",
            "region": "Київська область",
            "locality": "Переяслав-Хмельницький"
          },
          "contactPoint": {
            "name": "Ліповець Євген Іванович",
            "url": "http://www.shev.gov.ua/",
            "telephone": "2341170",
            "faxNumber": "2343591",
            "name_en": "Gregory Gillespie",
            "email": "buh510@ukr.net",
            "availableLanguage": "en"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\"",
            "id": "00037256",
            "legalName": "Шевченківська районна в місті Києві державна адміністрація"
          },
          "name_en": "Angelica Davis"
        },
        "numberOfContracts": 3,
        "mode": "test",
        "title_ru": "[ТЕСТИРОВАНИЕ] ",
        "owner": "broker",
        "dateModified": "2018-09-17T16:26:31.372995+03:00",
        "tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32"
      }
    ],
    "id": "6ccc95c340c94e32bcf0b8c2183e62f7",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ]
  }
}

We see the added properies have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.

Checking the listing again reflects the new modification date:

GET /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "offset": "2019-10-25T01:00:00+03:00"
  },
  "data": [
    {
      "id": "6ccc95c340c94e32bcf0b8c2183e62f7",
      "dateModified": "2019-10-25T01:00:00+03:00"
    },
    {
      "id": "c4b851839b51462fbf72e030424fca88",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

Procuring entity can set bid guarantee:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/lots/1b75c06ee58f4909a4201255b4ba5831?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 57
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "guarantee": {
      "currency": "USD",
      "amount": 8
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "description": "Опис Лот №1",
    "title": "Лот №1",
    "minimalStep": {
      "currency": "UAH",
      "amount": 2.5,
      "valueAddedTaxIncluded": true
    },
    "value": {
      "currency": "UAH",
      "amount": 600.67,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "1b75c06ee58f4909a4201255b4ba5831",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    }
  }
}
You may modify the following fields on this stage of procedure:
  • in Tender - title, title_en, description, description_en, tenderPeriod: endDate
  • in Lot - title, description, title_en, description_en, minimalStep, amount
  • in Item - description, description_en, deliveryAddress, deliveryDate, quantity
  • Guarantee

tenderPeriod:endDate should differ from tender publication date at least on three days.

You can modify the same fields on this stage of procedure in the case of multiple Item selected.

Uploading documentation

Procuring entity should only upload digital signature on this stage of procedure.

Procuring entity can upload PDF files into the created tender. Uploading should follow the Documents Uploading rules.

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 320
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=8uDRYbZKOz9FMsekzty6ZteEOx0OVkSKwr%2FZ4YgohXFmWDjHEt4rF3UT5uKcrNwmpuMm4kPGf955nkzQbuBtAg%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/45b3da2674bc4cabaacf6eae668ba321
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "45b3da2674bc4cabaacf6eae668ba321",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/45b3da2674bc4cabaacf6eae668ba321 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "previousVersions": [],
    "id": "45b3da2674bc4cabaacf6eae668ba321",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

The single array element describes the uploaded document. We can upload more documents:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 333
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=JYS%2FNI86r2%2F%2BEPzCFYwiT%2BmnLmSlbQfejWEFKw3bNhqIz8rFUe6fTh86EAYHpNeBjjHy8DTtyeDiGfkoIIcPCA%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/c3be39b3c6954dcba33d6a72709ae9fa
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=q0nnIB4up5R30F0Rq98CvwEfE0M%2Fz0VgC1PpU161Z9rl%2FC52mSAwa6LR57d1PaLEH%252Bpe4HBBdMSGGlY9hOxXCg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "c3be39b3c6954dcba33d6a72709ae9fa",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

And again we can confirm that there are two documents uploaded.

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 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.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "45b3da2674bc4cabaacf6eae668ba321",
      "dateModified": "2019-10-25T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=q0nnIB4up5R30F0Rq98CvwEfE0M%2Fz0VgC1PpU161Z9rl%2FC52mSAwa6LR57d1PaLEH%252Bpe4HBBdMSGGlY9hOxXCg%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "c3be39b3c6954dcba33d6a72709ae9fa",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

Let’s add new documentType field with technicalSpecifications parameter to the previously uploaded document:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/45b3da2674bc4cabaacf6eae668ba321?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "documentType": "technicalSpecifications"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "documentType": "technicalSpecifications",
    "id": "45b3da2674bc4cabaacf6eae668ba321",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

Success! Response code is 200 OK and it confirms that documentType field with technicalSpecifications parameter was added .

Now let’s try to modify any field in our document. For example, description:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/45b3da2674bc4cabaacf6eae668ba321?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 58
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "document description modified"
  }
}

Response: 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.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "author": "tender_owner",
    "documentType": "technicalSpecifications",
    "id": "45b3da2674bc4cabaacf6eae668ba321",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

200 OK response was returned. The description was modified successfully.

In case we made an error, we can reupload the document over the older version:

PUT /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents/c3be39b3c6954dcba33d6a72709ae9fa?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 335
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=Hco27SOxEFWNRg15WQtbku%2BRHvrF71z%2F4EwBEx9Q4g5LFQjByRABi4MWl%2BAEF%2FtfKIIfzigRC9EsE5SKKf0GBQ%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "AwardCriteria-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=e3FMzyWIbV16OyRubrjsJYuYsFSTPG91PjuH8hiqKO1kbwM4tlroiQgICT4uTQPVHcC%2FdPtdLmNh0EgObct0CA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "c3be39b3c6954dcba33d6a72709ae9fa",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

And we can see that it is overriding the original version:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/documents HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 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.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "45b3da2674bc4cabaacf6eae668ba321",
      "dateModified": "2019-10-25T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria-2.pdf",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=e3FMzyWIbV16OyRubrjsJYuYsFSTPG91PjuH8hiqKO1kbwM4tlroiQgICT4uTQPVHcC%2FdPtdLmNh0EgObct0CA%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "c3be39b3c6954dcba33d6a72709ae9fa",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

Registering bid

Step-by-step registration

When Tender.tenderingPeriod.startDate comes, Tender switches to active.tendering status that allows registration of bids.

Bidder can register a bid in draft status:

You cannot submit a bid greater than agreement.contract.value. Also Bidder can’t submit a bid if he is not party of this Framework Agreement (Agreement in cfaua).

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 953
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "value": {
          "amount": 500
        }
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ]
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Bid is not a member of agreement",
      "location": "body",
      "name": "data"
    }
  ]
}
POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1058
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "draft",
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "value": {
          "amount": 500
        }
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878
{
  "access": {
    "transfer": "65bb6d881aa348afa3de97420545b5a3",
    "token": "ebff7d432d3d4d0a8756f67f9bb07ef5"
  },
  "data": {
    "status": "draft",
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2019-10-25T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        }
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2019-10-25T01:00:00+03:00",
    "id": "cc8919c6d27b47e89829b7c64b3a7878"
  }
}

And activate a bid:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2019-10-25T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        }
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2019-10-25T01:00:00+03:00",
    "id": "cc8919c6d27b47e89829b7c64b3a7878"
  }
}

Bidder should only upload digital signature on this stage of procedure.

Upload proposal document:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878/documents?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 HTTP/1.0
Authorization: Bearer broker
Content-Length: 328
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/396c2bbf6e0c4ea1aa1292ff2f195d11?KeyID=a8968c46&Signature=cnar%2FZgM4vfn7TicnryGD60z0vXD34ooZcKdAi%2BKTOZZNVOahjEOyOo2d6LUiQvPxO%2FwfL1fB%2FBTXknWPTepCg%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878/documents/b84352b9f54c4f14bf296d9b79f48ebc
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Proposal.pdf",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878/documents/b84352b9f54c4f14bf296d9b79f48ebc?download=396c2bbf6e0c4ea1aa1292ff2f195d11",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "b84352b9f54c4f14bf296d9b79f48ebc",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

It is possible to check the uploaded documents:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878/documents?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "Proposal.pdf",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878/documents/b84352b9f54c4f14bf296d9b79f48ebc?download=396c2bbf6e0c4ea1aa1292ff2f195d11",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "b84352b9f54c4f14bf296d9b79f48ebc",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

Batch-mode registration

Register bid with documents using one request:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids HTTP/1.0
Authorization: Bearer broker
Content-Length: 1702
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "documents": [
      {
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f4853348bbbc4a6faa08d0e2891ea2e8?KeyID=a8968c46&Signature=7oKZXvaJ1DSjHrye7Vper58fwy6SgxlPENkC8Dp%2BE%2FOdlns3tx9gSDonjNtipPzuXjfjbMkQzsQ1pK%2FkJp%2FgCg%3D%3D",
        "format": "application/pdf",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf"
      },
      {
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e8f2a6a130ba44bb8e93f4056a8dbab7?KeyID=a8968c46&Signature=vDgXtbdz7NMXj2A8EujrSzjYTDZsd3d9TbAgAkG66CBgJJAuJ3z9jwF6R3M2tFHG7Evit2visH%2FEzt%2FDqmmABw%3D%3D",
        "format": "application/pdf",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf"
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "value": {
          "amount": 499
        }
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3401f691dc94a84ba7daa8eb8e0c4f0
{
  "access": {
    "transfer": "9ae4e56edcfb4eb69c010689a3f89041",
    "token": "8c1be9249ea8445480b4c4e3ec6ee974"
  },
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3401f691dc94a84ba7daa8eb8e0c4f0/documents/c5f17f5d6bd94560afb4e4276f410310?download=f4853348bbbc4a6faa08d0e2891ea2e8",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "c5f17f5d6bd94560afb4e4276f410310",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3401f691dc94a84ba7daa8eb8e0c4f0/documents/39a5a8f376d04e31b0dff87300913f99?download=e8f2a6a130ba44bb8e93f4056a8dbab7",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "39a5a8f376d04e31b0dff87300913f99",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2019-10-25T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 499.0,
          "valueAddedTaxIncluded": true
        }
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2019-10-25T01:00:00+03:00",
    "id": "d3401f691dc94a84ba7daa8eb8e0c4f0"
  }
}

Auction

After auction is scheduled anybody can visit it to watch. The auction can be reached at Tender.auctionUrl:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "selective",
    "features": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
        "title": "Потужність всмоктування",
        "enum": [
          {
            "value": 0.1,
            "title": "До 1000 Вт"
          },
          {
            "value": 0.15,
            "title": "Більше 1000 Вт"
          }
        ],
        "title_en": "Air Intake",
        "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "featureOf": "item"
      },
      {
        "code": "OCDS-123454-YEARS",
        "description": "Кількість років, які організація учасник працює на ринку",
        "title": "Років на ринку",
        "enum": [
          {
            "value": 0.05,
            "title": "До 3 років"
          },
          {
            "value": 0.1,
            "title": "Більше 3 років, менше 5 років"
          },
          {
            "value": 0.15,
            "title": "Більше 5 років"
          }
        ],
        "title_en": "Years trading",
        "featureOf": "tenderer"
      }
    ],
    "enquiryPeriod": {
      "startDate": "2019-10-21T01:00:00+03:00",
      "endDate": "2019-10-22T01:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2019-10-25T01:42:00+03:00",
    "procuringEntity": {
      "kind": "general",
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      },
      "additionalContactPoints": [
        {
          "name": "Державне управління справами 1",
          "availableLanguage": "uk",
          "telephone": "0440000000"
        }
      ],
      "contactPoint": {
        "name": "Державне управління справами",
        "availableLanguage": "en",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      }
    },
    "owner": "broker",
    "id": "6ccc95c340c94e32bcf0b8c2183e62f7",
    "guarantee": {
      "currency": "USD",
      "amount": 8.0
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description modified",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/989723c05a4246dfa9199c3727deb4a6?KeyID=a8968c46&Signature=y87Tei%252BRdqEID6fl815tazVP1pwISubhiT5bdGHlJEPuxxPlYcYebcmQHc3SVjf%252Bmznstx8QJ19JB7s8tQ6yCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "author": "tender_owner",
        "documentType": "technicalSpecifications",
        "id": "45b3da2674bc4cabaacf6eae668ba321",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5b9474dc1ef04f6cb854b9b7ece6a280?KeyID=a8968c46&Signature=q0nnIB4up5R30F0Rq98CvwEfE0M%2Fz0VgC1PpU161Z9rl%2FC52mSAwa6LR57d1PaLEH%252Bpe4HBBdMSGGlY9hOxXCg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "c3be39b3c6954dcba33d6a72709ae9fa",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "tender_owner",
        "title": "AwardCriteria-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/47d4864c89104801b7903301080f2b67?KeyID=a8968c46&Signature=e3FMzyWIbV16OyRubrjsJYuYsFSTPG91PjuH8hiqKO1kbwM4tlroiQgICT4uTQPVHcC%2FdPtdLmNh0EgObct0CA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "c3be39b3c6954dcba33d6a72709ae9fa",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "title": "футляри до державних нагород",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "auctionUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/6ccc95c340c94e32bcf0b8c2183e62f7_1b75c06ee58f4909a4201255b4ba5831",
        "auctionPeriod": {
          "startDate": "2019-10-25T01:00:00+03:00",
          "shouldStartAfter": "2019-10-26T00:00:00+03:00"
        },
        "value": {
          "currency": "UAH",
          "amount": 600.666,
          "valueAddedTaxIncluded": true
        },
        "minimalStep": {
          "currency": "UAH",
          "amount": 3.0033300000000005,
          "valueAddedTaxIncluded": true
        },
        "date": "2019-10-25T01:00:00+03:00",
        "id": "1b75c06ee58f4909a4201255b4ba5831",
        "guarantee": {
          "currency": "USD",
          "amount": 8.0
        }
      }
    ],
    "tenderID": "UA-2019-10-25-000004",
    "dateModified": "2019-10-25T01:00:00+03:00",
    "agreements": [
      {
        "agreementID": "UA-2018-09-11-000002-1",
        "status": "active",
        "features": [
          {
            "code": "OCDS-123454-AIR-INTAKE",
            "description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
            "title": "Потужність всмоктування",
            "enum": [
              {
                "value": 0.1,
                "title": "До 1000 Вт"
              },
              {
                "value": 0.15,
                "title": "Більше 1000 Вт"
              }
            ],
            "title_en": "Air Intake",
            "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "featureOf": "item"
          },
          {
            "code": "OCDS-123454-YEARS",
            "description": "Кількість років, які організація учасник працює на ринку",
            "title": "Років на ринку",
            "enum": [
              {
                "value": 0.05,
                "title": "До 3 років"
              },
              {
                "value": 0.1,
                "title": "Більше 3 років, менше 5 років"
              },
              {
                "value": 0.15,
                "title": "Більше 5 років"
              }
            ],
            "title_en": "Years trading",
            "featureOf": "tenderer"
          }
        ],
        "title": "[ТЕСТУВАННЯ] ",
        "contracts": [
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "large",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037256",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "0a292b6466274139ad3d973fd64830ff",
            "date": "2018-07-30T17:40:15.471158+03:00",
            "awardID": "d7406b07c05b4796bb168a7c47ee7d31",
            "id": "d6cd8c3188d74e1481a9cebb57fd9329"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037257",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.666,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "unsuccessful",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.111,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами 1",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами 1",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037251",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.666,
              "valueAddedTaxIncluded": true
            },
            "bidID": "d85ef51272f14087abb2eed535340493",
            "date": "2018-07-30T17:40:15.471207+03:00",
            "awardID": "cdb6da320600480d8eaabd8eaa920872",
            "id": "c8ef8c0d1cb74528b13335a623225762"
          },
          {
            "status": "active",
            "parameters": [
              {
                "code": "OCDS-123454-AIR-INTAKE",
                "value": 0.1
              },
              {
                "code": "OCDS-123454-YEARS",
                "value": 0.1
              }
            ],
            "unitPrices": [
              {
                "value": {
                  "currency": "UAH",
                  "amount": 100.0,
                  "valueAddedTaxIncluded": true
                },
                "relatedItem": "1662b0e1d59f4e2f8e2c5bd48e03a7bc"
              }
            ],
            "suppliers": [
              {
                "contactPoint": {
                  "name": "Державне управління справами",
                  "telephone": "0440000000"
                },
                "scale": "micro",
                "name": "Державне управління справами",
                "identifier": {
                  "scheme": "UA-EDR",
                  "id": "00037258",
                  "uri": "http://www.dus.gov.ua/"
                },
                "address": {
                  "postalCode": "01220",
                  "countryName": "Україна",
                  "streetAddress": "вул. Банкова, 11, корпус 1",
                  "region": "м. Київ",
                  "locality": "м. Київ"
                }
              }
            ],
            "value": {
              "currency": "UAH",
              "amount": 600.0,
              "valueAddedTaxIncluded": true
            },
            "bidID": "fc02090c338a477f8013156a4fa2da10",
            "date": "2018-07-30T17:40:15.471264+03:00",
            "awardID": "a915a07f7f0b4dafa583cce119bf1823",
            "id": "d925d6c6124447d581f2ae5f52ba710f"
          }
        ],
        "items": [
          {
            "description": "футляри до державних нагород",
            "classification": {
              "scheme": "ДК021",
              "description": "Cartons",
              "id": "44617100-9"
            },
            "description_en": "Cases for state awards",
            "additionalClassifications": [
              {
                "scheme": "ДКПП",
                "id": "17.21.1",
                "description": "папір і картон гофровані, паперова й картонна тара"
              }
            ],
            "deliveryAddress": {
              "postalCode": "79000",
              "countryName": "Україна",
              "streetAddress": "вул. Банкова 1",
              "region": "м. Київ",
              "locality": "м. Київ"
            },
            "deliveryDate": {
              "startDate": "2018-06-27T13:39:09.362837+03:00",
              "endDate": "2018-06-30T13:39:09.362837+03:00"
            },
            "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
            "unit": {
              "code": "44617100-9",
              "name": "item"
            },
            "quantity": 5.0
          }
        ],
        "title_en": "[TESTING] ",
        "period": {
          "startDate": "2018-09-11T11:23:20.418390+03:00",
          "endDate": "2022-01-23T11:23:20.418436+03:00"
        },
        "dateSigned": "2018-09-11T11:23:23.220310+03:00",
        "id": "106468013e6f47398b6f2f4da3bdeba6",
        "procuringEntity": {
          "kind": "general",
          "name": "Шевченківська районна в місті Києві державна адміністрація",
          "address": {
            "postalCode": "01030",
            "countryName": "Україна",
            "streetAddress": "Богдана Хмельницького вулиця, 21-29",
            "region": "Київська область",
            "locality": "Переяслав-Хмельницький"
          },
          "contactPoint": {
            "name": "Ліповець Євген Іванович",
            "url": "http://www.shev.gov.ua/",
            "telephone": "2341170",
            "faxNumber": "2343591",
            "name_en": "Gregory Gillespie",
            "email": "buh510@ukr.net",
            "availableLanguage": "en"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName_en": "Institution \"Vinnytsia City Council primary and secondary general school № 10\"",
            "id": "00037256",
            "legalName": "Шевченківська районна в місті Києві державна адміністрація"
          },
          "name_en": "Angelica Davis"
        },
        "numberOfContracts": 3,
        "mode": "test",
        "title_ru": "[ТЕСТИРОВАНИЕ] ",
        "owner": "broker",
        "dateModified": "2018-09-17T16:26:31.372995+03:00",
        "tender_id": "c3f4116d38d34fe2b7d8de8aae8c0b32"
      }
    ],
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2019-10-22T01:00:00+03:00",
      "endDate": "2019-10-25T01:00:00+03:00"
    },
    "procurementMethodType": "closeFrameworkAgreementSelectionUA",
    "date": "2019-10-25T01:00:00+03:00",
    "minimalStep": {
      "currency": "UAH",
      "amount": 3.0033300000000005,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 600.666,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "lowestCost"
  }
}

And bidders can find out their participation URLs via their bids:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878?acc_token=ebff7d432d3d4d0a8756f67f9bb07ef5 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/cc8919c6d27b47e89829b7c64b3a7878/documents/b84352b9f54c4f14bf296d9b79f48ebc?download=396c2bbf6e0c4ea1aa1292ff2f195d11",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "b84352b9f54c4f14bf296d9b79f48ebc",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2019-10-25T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 500.0,
          "valueAddedTaxIncluded": true
        },
        "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/6ccc95c340c94e32bcf0b8c2183e62f7_1b75c06ee58f4909a4201255b4ba5831?key_for_bid=cc8919c6d27b47e89829b7c64b3a7878"
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "large",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2019-10-25T01:00:00+03:00",
    "id": "cc8919c6d27b47e89829b7c64b3a7878"
  }
}

See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3401f691dc94a84ba7daa8eb8e0c4f0?acc_token=8c1be9249ea8445480b4c4e3ec6ee974 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part1.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3401f691dc94a84ba7daa8eb8e0c4f0/documents/c5f17f5d6bd94560afb4e4276f410310?download=f4853348bbbc4a6faa08d0e2891ea2e8",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "c5f17f5d6bd94560afb4e4276f410310",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Proposal_part2.pdf",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/bids/d3401f691dc94a84ba7daa8eb8e0c4f0/documents/39a5a8f376d04e31b0dff87300913f99?download=e8f2a6a130ba44bb8e93f4056a8dbab7",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "39a5a8f376d04e31b0dff87300913f99",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "parameters": [
      {
        "code": "OCDS-123454-AIR-INTAKE",
        "value": 0.1
      },
      {
        "code": "OCDS-123454-YEARS",
        "value": 0.1
      }
    ],
    "lotValues": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "date": "2019-10-25T01:00:00+03:00",
        "value": {
          "currency": "UAH",
          "amount": 499.0,
          "valueAddedTaxIncluded": true
        },
        "participationUrl": "http://auction-sandbox.prozorro.gov.ua/tenders/6ccc95c340c94e32bcf0b8c2183e62f7_1b75c06ee58f4909a4201255b4ba5831?key_for_bid=d3401f691dc94a84ba7daa8eb8e0c4f0"
      }
    ],
    "tenderers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "date": "2019-10-25T01:00:00+03:00",
    "id": "d3401f691dc94a84ba7daa8eb8e0c4f0"
  }
}

Listing awards

The pending award can be retrieved via request to list all available awards:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "status": "pending",
      "lotID": "1b75c06ee58f4909a4201255b4ba5831",
      "suppliers": [
        {
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "0440000000"
          },
          "scale": "micro",
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037257",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "postalCode": "01220",
            "countryName": "Україна",
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "region": "м. Київ",
            "locality": "м. Київ"
          }
        }
      ],
      "bid_id": "d3401f691dc94a84ba7daa8eb8e0c4f0",
      "value": {
        "currency": "UAH",
        "amount": 499.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2019-10-25T01:00:00+03:00",
      "id": "d08a35e2285e472b96759a1401934d88"
    }
  ]
}

Confirming qualification

Let’s try to disqualify award by switching it’s status from pending to unsuccessful.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/d08a35e2285e472b96759a1401934d88?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "unsuccessful"
  }
}

Response: 403 Forbidden
Content-Type: application/json; charset=UTF-8
{
  "status": "error",
  "errors": [
    {
      "description": "Can't update award status to unsuccessful, if tender status is active.qualification and there is no cancelled award with the same bid_id",
      "location": "body",
      "name": "data"
    }
  ]
}

As we can see it is impossible. Procuring entity should activate pending award at first and switch it to cancelled status then.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/d08a35e2285e472b96759a1401934d88?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "d3401f691dc94a84ba7daa8eb8e0c4f0",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "d08a35e2285e472b96759a1401934d88"
  }
}

Now cancelling active award.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/d08a35e2285e472b96759a1401934d88?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "cancelled"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17
{
  "data": {
    "status": "cancelled",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "d3401f691dc94a84ba7daa8eb8e0c4f0",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "d08a35e2285e472b96759a1401934d88"
  }
}

We see that new pending award is generated for the same bidder now. So we can successfully switch this pending award to unsuccessful.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 36
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "unsuccessful"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/1c87ef6c69a34696b307f78e1d9839e7
{
  "data": {
    "status": "unsuccessful",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037257",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "d3401f691dc94a84ba7daa8eb8e0c4f0",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "19ec6d107424404daa2b35ae7a2d2c17"
  }
}

You can upload award documents. Let’s upload award document

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 327
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1addeea14e464014a69fc26373ed4ce7?KeyID=a8968c46&Signature=g3SinQzaISnyJ4e7X8K4Z%2FVqYvM4ZWY0FbYCDZEG2futZNssj%2BsGwtbiZkrrbJBpRZjugaWzQgQX2aBrnUt6Cw%3D%3D",
    "title": "explanation.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/19ec6d107424404daa2b35ae7a2d2c17/documents/39f011b798b048c7af4b67542940dbcb
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "tender_owner",
    "title": "explanation.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1addeea14e464014a69fc26373ed4ce7?KeyID=a8968c46&Signature=cFYAgXTGMi6MvJJXxnFQ89WDxivteFxIDAS16fb1M9b11BvxQuV32fIuXGGM8lm3JXP6xXMqSsV5FZvJ2PKtDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "39f011b798b048c7af4b67542940dbcb",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

Qualification comission registers its decision via the following call:

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/awards/1c87ef6c69a34696b307f78e1d9839e7?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "lotID": "1b75c06ee58f4909a4201255b4ba5831",
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "bid_id": "c3628384efdd45669ec7a27a34d989db",
    "value": {
      "currency": "UAH",
      "amount": 499.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "1c87ef6c69a34696b307f78e1d9839e7"
  }
}

Procuring entity should fill the information about extension of the bidder’s term in the description field.

Setting contract value

By default contract value is set based on the award, but there is a possibility to set custom contract value.

If you want to lower contract value, you can insert new one into the amount field.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 91
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "contractNumber": "contract #13111",
    "value": {
      "amount": 238,
      "amountNet": 230
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "awardID": "1c87ef6c69a34696b307f78e1d9839e7",
    "id": "632f182366214a9aa18a7cbe72724559",
    "contractID": "UA-2019-10-25-000004-2"
  }
}

200 OK response was returned. The value was modified successfully.

Setting contract signature date

There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.

If this date is not set, it will be auto-generated on the date of contract registration.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "dateSigned": "2019-10-25T01:00:00+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
null

Setting contract validity period

Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "period": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2020-10-24T01:00:00+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2020-10-24T01:00:00+03:00"
    },
    "dateSigned": "2019-10-25T01:00:00+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "awardID": "1c87ef6c69a34696b307f78e1d9839e7",
    "id": "632f182366214a9aa18a7cbe72724559",
    "contractID": "UA-2019-10-25-000004-2"
  }
}

Uploading contract documentation

You can upload contract documents. Let’s upload contract document:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 338
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=GWgm3s9sT2xN6SXHM4C6PzpgGMUgV69PdCwE3MKfp1Vckf4rqPP1BwSutTIkpQuFcn00ktU543itmxYgkFxgCA%3D%3D",
    "title": "contract_first_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents/d06c0f6b9a9f4064bbd32fd6c64cf5da
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
    "format": "application/msword",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "d06c0f6b9a9f4064bbd32fd6c64cf5da",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

201 Created response code and Location header confirm document was added.

Let’s see the list of contract documents:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
      "format": "application/msword",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "d06c0f6b9a9f4064bbd32fd6c64cf5da",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

We can add another contract document:

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 347
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=XR7Q0FBAjJfMChcHbnJayqL5nEDZrd7%2BQbj2eXFhKfFOnwpkv%2Bsj2brsD%2FVglEK%2BaSQFyxr7Bmf0VaCqFmpJDw%3D%3D",
    "title": "contract_second_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents/eb61c2895813420ea67c7baa86c980b9
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_second_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=ecUmeR1kbP138C3RdAt76nq%2FPC6qYvVU9Kei5DuhrS72l%252BFJQh4GqCxMJAslC1VhN391Az%2FifrpGFIfPIgJmAQ%253D%253D",
    "format": "application/msword",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "eb61c2895813420ea67c7baa86c980b9",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

201 Created response code and Location header confirm second document was uploaded.

Let’s see the list of all added contract documents:

GET /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559/documents HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
      "format": "application/msword",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "d06c0f6b9a9f4064bbd32fd6c64cf5da",
      "dateModified": "2019-10-25T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_second_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=ecUmeR1kbP138C3RdAt76nq%2FPC6qYvVU9Kei5DuhrS72l%252BFJQh4GqCxMJAslC1VhN391Az%2FifrpGFIfPIgJmAQ%253D%253D",
      "format": "application/msword",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "eb61c2895813420ea67c7baa86c980b9",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

Set contract signature date

There is a possibility to set custom contract signature date. If the date is not set it will be generated on contract registration.

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "dateSigned": "2019-10-25T01:00:00+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
null

Contract registration

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/contracts/632f182366214a9aa18a7cbe72724559?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_first_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0f746bb86abe44069b70422d6460b960?KeyID=a8968c46&Signature=pSYFHP3nW5EEk%2FIRb2QtEpFxYLsjj6qRelcysPR0of3o%2Fw7RiugEvP0mQ0%252BTwF%2FI9tUIUc6MDtRrLGReXyaRCw%253D%253D",
        "format": "application/msword",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "d06c0f6b9a9f4064bbd32fd6c64cf5da",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_second_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/99561094e8ff41baa176155995a9e23c?KeyID=a8968c46&Signature=ecUmeR1kbP138C3RdAt76nq%2FPC6qYvVU9Kei5DuhrS72l%252BFJQh4GqCxMJAslC1VhN391Az%2FifrpGFIfPIgJmAQ%253D%253D",
        "format": "application/msword",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "eb61c2895813420ea67c7baa86c980b9",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "items": [
      {
        "relatedLot": "1b75c06ee58f4909a4201255b4ba5831",
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "New Cartons",
          "id": "44617100-9"
        },
        "description_en": "futliary do derzhavnyh nagorod",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "1662b0e1d59f4e2f8e2c5bd48e03a7bc",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 6.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037258",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "contractNumber": "contract #13111",
    "period": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2020-10-24T01:00:00+03:00"
    },
    "dateSigned": "2019-10-25T01:00:00+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "awardID": "1c87ef6c69a34696b307f78e1d9839e7",
    "id": "632f182366214a9aa18a7cbe72724559",
    "contractID": "UA-2019-10-25-000004-2"
  }
}

To see more information about contract look at the Contracting API interface to OpenProcurement database.

Cancelling tender

Tender creator can cancel tender anytime (except when tender has terminal status e.g. usuccesfull, canceled, complete).

The following steps should be applied:

  1. Prepare cancellation request
  2. Fill it with the protocol describing the cancellation reasons
  3. Cancel the tender with the reasons prepared.

Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.

See Cancellation data structure for details.

Preparing the cancellation request

You should pass reason, status defaults to pending. id is autogenerated and passed in the Location header of response.

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 43
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reason": "cancellation reason"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/5f5eefc0839c4a10bd3291cfd05e33c8
{
  "data": {
    "date": "2019-10-25T01:00:00+03:00",
    "status": "pending",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "id": "5f5eefc0839c4a10bd3291cfd05e33c8"
  }
}

Filling cancellation with protocol and supplementary documentation

Upload the file contents

POST /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/5f5eefc0839c4a10bd3291cfd05e33c8/documents?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 324
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=ay27Vp7P3jwF2D6XQmxeUkF7gRhhqMfPq%2FWi2aaO70I2E%2Fj0PPPrAVFYMcT4PUpxP8gu%2FXP3Wi37qI2bnIR6BA%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/5f5eefc0839c4a10bd3291cfd05e33c8/documents/706eee2233914342baaa25ffce3d32db
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=vVwW2Pnc5ejmkSqNdboN37wa3V4ltqaQZu2pY0usENv209SCO8ToI%2FSyx9uGjZ5%2FNLA6V8HfpSxOghFgK0ssDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "706eee2233914342baaa25ffce3d32db",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

Change the document description and other properties

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/5f5eefc0839c4a10bd3291cfd05e33c8/documents/706eee2233914342baaa25ffce3d32db?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "Changed description"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=vVwW2Pnc5ejmkSqNdboN37wa3V4ltqaQZu2pY0usENv209SCO8ToI%2FSyx9uGjZ5%2FNLA6V8HfpSxOghFgK0ssDg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "706eee2233914342baaa25ffce3d32db",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

Upload new version of the document

PUT /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/5f5eefc0839c4a10bd3291cfd05e33c8/documents/706eee2233914342baaa25ffce3d32db?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 320
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7f0db24e96b840119a36e08f003d9268?KeyID=a8968c46&Signature=CB1XYNG1ENUU8GBBhDrWdNITTC7YmKyitZ8aXWbYWKZPNHMVW9zFhnAeOG8rgR3GHtZNXl7WJ7xP2TGVHDjbBg%3D%3D",
    "title": "Notice-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7f0db24e96b840119a36e08f003d9268?KeyID=a8968c46&Signature=22jMWSDGxJLq9%252BWiDY2%252BZ4%2FJVxRWKdEG6A6NB%252BCVi%2FkxEbGhpnmbsTS%252BQ4tf3jSVKG%2FHtZRY77p3F4dzeGiJCg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "706eee2233914342baaa25ffce3d32db",
    "dateModified": "2019-10-25T01:00:00+03:00"
  }
}

Activating the request and cancelling tender

PATCH /api/2.5/tenders/6ccc95c340c94e32bcf0b8c2183e62f7/cancellations/5f5eefc0839c4a10bd3291cfd05e33c8?acc_token=794fefa6abd34c81a289161fadb1feb4 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/4bc35d2c863844b4a951f9ad7a7c3422?KeyID=a8968c46&Signature=vVwW2Pnc5ejmkSqNdboN37wa3V4ltqaQZu2pY0usENv209SCO8ToI%2FSyx9uGjZ5%2FNLA6V8HfpSxOghFgK0ssDg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "706eee2233914342baaa25ffce3d32db",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7f0db24e96b840119a36e08f003d9268?KeyID=a8968c46&Signature=22jMWSDGxJLq9%252BWiDY2%252BZ4%2FJVxRWKdEG6A6NB%252BCVi%2FkxEbGhpnmbsTS%252BQ4tf3jSVKG%2FHtZRY77p3F4dzeGiJCg%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "706eee2233914342baaa25ffce3d32db",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "reason": "cancellation reason",
    "date": "2019-10-25T01:00:00+03:00",
    "cancellationOf": "tender",
    "id": "5f5eefc0839c4a10bd3291cfd05e33c8"
  }
}

It may be useful to see top requirements: Test Cases for III level of accreditation and Test Cases for IV level of accreditation.