Bid Requirement response

Bid requirement response - an object that shows that the user meets the tender owner requirements, and can participate in the procurement.

Any action on the requirement response in the bid can be performed only by the bid owner.

Requirement response basic operation

Requirement response data scheme

Create Bid Requirement Response

You can create few requirement responses in one request with complete set of data.

Request

POST /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": [
    {
      "title": "Requirement response",
      "description": "some description",
      "requirement": {
        "id": "15d2ba1109184cb695b1d750c8bc5e66",
        "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
      },
      "evidences": [
        {
          "title": "Requirement response",
          "relatedDocument": {
            "id": "3367c62610004e63bc05756d076023cf",
            "title": "name.doc"
          },
          "type": "document"
        }
      ],
      "value": "True"
    }
  ]
}

Response

HTTP/1.0 201 Created
Content-Type: application/json

{
  "data": [
    {
      "title": "Requirement response",
      "description": "some description",
      "requirement": {
        "id": "15d2ba1109184cb695b1d750c8bc5e66",
        "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
      },
      "evidences": [
        {
          "title": "Requirement response",
          "type": "document",
          "relatedDocument": {
            "id": "3367c62610004e63bc05756d076023cf",
            "title": "name.doc"
          },
          "id": "697c479299af40a58282ea49a8222a0e"
        }
      ],
      "value": "True",
      "id": "14d996c8acb847beb5471b7cb1d2e980"
    }
  ]
}

You can create requirement responses in one request with bid patch.

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      }
    ]
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "8b32e0d2abce4a2f82ac149fd1d4a04a"
          }
        ],
        "value": "True",
        "id": "127b0d2413c94dab873d05f51128c693"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "672ede35710e43b9937a0e972724e47a"
          }
        ],
        "value": "True",
        "id": "7a37a37788ba4be3b1cf792a8157dd9a"
      }
    ],
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "scale": "micro"
      }
    ],
    "status": "draft",
    "id": "987b40daa8334398a3f222f3fb033be2",
    "date": "2023-10-10T01:00:00+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "lotValues": [
      {
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "ab777668b8ff4f4a82faccf36709dd59",
        "status": "pending",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "documents": [
      {
        "id": "3367c62610004e63bc05756d076023cf",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "name.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/eca1451a57d142f394808a9f0953822a?Signature=A5icXgC%2BjDHMUEXaX29uygDBZX9J6M9cqFFJ2zo16OfslBgPmX65qOyR9HdbASPCIYc%2Fgu5Rv6JBLxngz5v1Aw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk",
        "confidentiality": "public"
      }
    ],
    "selfQualified": true
  }
}

Update Bid Requirement Response

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Updated title"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Updated title",
    "description": "some description",
    "requirement": {
      "id": "15d2ba1109184cb695b1d750c8bc5e66",
      "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
    },
    "evidences": [
      {
        "title": "Requirement response",
        "type": "document",
        "relatedDocument": {
          "id": "3367c62610004e63bc05756d076023cf",
          "title": "name.doc"
        },
        "id": "697c479299af40a58282ea49a8222a0e"
      }
    ],
    "value": "True",
    "id": "14d996c8acb847beb5471b7cb1d2e980"
  }
}

You can patch requirement responses in one request with bid patch, and you must send data about other requirement responses or this other requirement responses will be deleted.

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response 1",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      }
    ]
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response 1",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "b0e1929549dd4303bd1dff574d07407b"
          }
        ],
        "value": "True",
        "id": "8f8e9b710397449a86741ccd905481da"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "2212c2c957cc4361806d371a6c408bd8"
          }
        ],
        "value": "True",
        "id": "962658803e214fabbaea8526630f84b9"
      }
    ],
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "scale": "micro"
      }
    ],
    "status": "draft",
    "id": "987b40daa8334398a3f222f3fb033be2",
    "date": "2023-10-10T01:00:00+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "lotValues": [
      {
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "ab777668b8ff4f4a82faccf36709dd59",
        "status": "pending",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "documents": [
      {
        "id": "3367c62610004e63bc05756d076023cf",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "name.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/eca1451a57d142f394808a9f0953822a?Signature=A5icXgC%2BjDHMUEXaX29uygDBZX9J6M9cqFFJ2zo16OfslBgPmX65qOyR9HdbASPCIYc%2Fgu5Rv6JBLxngz5v1Aw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk",
        "confidentiality": "public"
      }
    ],
    "selfQualified": true
  }
}

Get Bid Requirement Response

Request

GET /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "title": "Updated title",
      "description": "some description",
      "requirement": {
        "id": "15d2ba1109184cb695b1d750c8bc5e66",
        "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
      },
      "evidences": [
        {
          "title": "Requirement response",
          "type": "document",
          "relatedDocument": {
            "id": "3367c62610004e63bc05756d076023cf",
            "title": "name.doc"
          },
          "id": "697c479299af40a58282ea49a8222a0e"
        },
        {
          "title": "Update evidence title",
          "type": "document",
          "relatedDocument": {
            "id": "3367c62610004e63bc05756d076023cf",
            "title": "name.doc"
          },
          "id": "546c149c738f4a47a80aa2a53a0df716"
        }
      ],
      "value": "True",
      "id": "14d996c8acb847beb5471b7cb1d2e980"
    }
  ]
}

Request

GET /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980 HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Updated title",
    "description": "some description",
    "requirement": {
      "id": "15d2ba1109184cb695b1d750c8bc5e66",
      "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
    },
    "evidences": [
      {
        "title": "Requirement response",
        "type": "document",
        "relatedDocument": {
          "id": "3367c62610004e63bc05756d076023cf",
          "title": "name.doc"
        },
        "id": "697c479299af40a58282ea49a8222a0e"
      },
      {
        "title": "Update evidence title",
        "type": "document",
        "relatedDocument": {
          "id": "3367c62610004e63bc05756d076023cf",
          "title": "name.doc"
        },
        "id": "546c149c738f4a47a80aa2a53a0df716"
      }
    ],
    "value": "True",
    "id": "14d996c8acb847beb5471b7cb1d2e980"
  }
}

Delete Requirement Response

Request

DELETE /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Host: lb-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Updated title",
    "description": "some description",
    "requirement": {
      "id": "15d2ba1109184cb695b1d750c8bc5e66",
      "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
    },
    "evidences": [
      {
        "title": "Requirement response",
        "type": "document",
        "relatedDocument": {
          "id": "3367c62610004e63bc05756d076023cf",
          "title": "name.doc"
        },
        "id": "697c479299af40a58282ea49a8222a0e"
      }
    ],
    "value": "True",
    "id": "14d996c8acb847beb5471b7cb1d2e980"
  }
}

You can delete requirement responses in one request with bid patch, not send this requirement response data.

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Updated title"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Updated title",
    "description": "some description",
    "requirement": {
      "id": "15d2ba1109184cb695b1d750c8bc5e66",
      "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
    },
    "evidences": [
      {
        "title": "Requirement response",
        "type": "document",
        "relatedDocument": {
          "id": "3367c62610004e63bc05756d076023cf",
          "title": "name.doc"
        },
        "id": "697c479299af40a58282ea49a8222a0e"
      }
    ],
    "value": "True",
    "id": "14d996c8acb847beb5471b7cb1d2e980"
  }
}

Evidence basic operation

Evidence data scheme

Create Requirement Response Evidence

Request

POST /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980/evidences?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Requirement response",
    "relatedDocument": {
      "id": "3367c62610004e63bc05756d076023cf",
      "title": "name.doc"
    },
    "type": "document"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json

{
  "data": {
    "title": "Requirement response",
    "type": "document",
    "relatedDocument": {
      "id": "3367c62610004e63bc05756d076023cf",
      "title": "name.doc"
    },
    "id": "546c149c738f4a47a80aa2a53a0df716"
  }
}

Update Requirement Response Evidence

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980/evidences/546c149c738f4a47a80aa2a53a0df716?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Update evidence title"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Update evidence title",
    "type": "document",
    "relatedDocument": {
      "id": "3367c62610004e63bc05756d076023cf",
      "title": "name.doc"
    },
    "id": "546c149c738f4a47a80aa2a53a0df716"
  }
}

Get Requirement Response Evidence

Request

GET /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980/evidences HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "title": "Requirement response",
      "type": "document",
      "relatedDocument": {
        "id": "3367c62610004e63bc05756d076023cf",
        "title": "name.doc"
      },
      "id": "697c479299af40a58282ea49a8222a0e"
    },
    {
      "title": "Update evidence title",
      "type": "document",
      "relatedDocument": {
        "id": "3367c62610004e63bc05756d076023cf",
        "title": "name.doc"
      },
      "id": "546c149c738f4a47a80aa2a53a0df716"
    }
  ]
}

Request

GET /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980/evidences/546c149c738f4a47a80aa2a53a0df716 HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Update evidence title",
    "type": "document",
    "relatedDocument": {
      "id": "3367c62610004e63bc05756d076023cf",
      "title": "name.doc"
    },
    "id": "546c149c738f4a47a80aa2a53a0df716"
  }
}

Delete Requirement Response Evidence

Request

DELETE /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2/requirement_responses/14d996c8acb847beb5471b7cb1d2e980/evidences/546c149c738f4a47a80aa2a53a0df716?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Host: lb-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "title": "Update evidence title",
    "type": "document",
    "relatedDocument": {
      "id": "3367c62610004e63bc05756d076023cf",
      "title": "name.doc"
    },
    "id": "546c149c738f4a47a80aa2a53a0df716"
  }
}

Bid activation

When you update bid to active/pending status or PATCH bid in these statuses, the validation is triggered that checks the compliance of the responses and criteria requirements.

Responses are necessary only for criteria that have at least one requirement in status “active”.

Error when bid doesn’t have response for one of criteria:

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      }
    ]
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "a519e7caad93435a9412b5cb2b0750f6"
          }
        ],
        "value": "True",
        "id": "a11d24140fef4267b6e7098a7db354f3"
      }
    ],
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "scale": "micro"
      }
    ],
    "status": "draft",
    "id": "987b40daa8334398a3f222f3fb033be2",
    "date": "2023-10-10T01:00:00+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "lotValues": [
      {
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "ab777668b8ff4f4a82faccf36709dd59",
        "status": "pending",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "documents": [
      {
        "id": "3367c62610004e63bc05756d076023cf",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "name.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/eca1451a57d142f394808a9f0953822a?Signature=A5icXgC%2BjDHMUEXaX29uygDBZX9J6M9cqFFJ2zo16OfslBgPmX65qOyR9HdbASPCIYc%2Fgu5Rv6JBLxngz5v1Aw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk",
        "confidentiality": "public"
      }
    ],
    "selfQualified": true
  }
}

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "pending"
  }
}

Response

HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "requirementResponses",
      "description": [
        "Must be answered on all criteria with source `tenderer` and GUARANTEE if declared"
      ]
    }
  ]
}

Error when bid have responses for few requirement groups inside one criteria:

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      },
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "f0549eeb7a924e94895d48e9a558ed80",
          "title": "Службова (посадова) особа учасника процедури закупівлі, яка підписала тендерну пропозицію (або уповноважена на підписання договору в разі переговорної процедури закупівлі), не була засуджена за злочин, вчинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом, шахрайством та відмиванням коштів), судимість з якої  знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      }
    ]
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "fa6e7a345e404392bae87cbe2943a3cf"
          }
        ],
        "value": "True",
        "id": "95320b5593144cd192e45b977526de97"
      },
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "f0549eeb7a924e94895d48e9a558ed80",
          "title": "Службова (посадова) особа учасника процедури закупівлі, яка підписала тендерну пропозицію (або уповноважена на підписання договору в разі переговорної процедури закупівлі), не була засуджена за злочин, вчинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом, шахрайством та відмиванням коштів), судимість з якої  знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "4d9d1646f35342fbbfdc90e3f483d75b"
          }
        ],
        "value": "True",
        "id": "19ffeb9faa1d4dc58b7e616c50bb1ad4"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "226b79307093409b87dbb1783d3de658"
          }
        ],
        "value": "True",
        "id": "5ae175947c7f46b1adbb8f9d38cb714c"
      }
    ],
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "scale": "micro"
      }
    ],
    "status": "draft",
    "id": "987b40daa8334398a3f222f3fb033be2",
    "date": "2023-10-10T01:00:00+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "lotValues": [
      {
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "ab777668b8ff4f4a82faccf36709dd59",
        "status": "pending",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "documents": [
      {
        "id": "3367c62610004e63bc05756d076023cf",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "name.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/eca1451a57d142f394808a9f0953822a?Signature=A5icXgC%2BjDHMUEXaX29uygDBZX9J6M9cqFFJ2zo16OfslBgPmX65qOyR9HdbASPCIYc%2Fgu5Rv6JBLxngz5v1Aw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk",
        "confidentiality": "public"
      }
    ],
    "selfQualified": true
  }
}

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "pending"
  }
}

Response

HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "requirementResponses",
      "description": [
        "Inside criteria must be answered only one requirement group"
      ]
    }
  ]
}

Error when bid doesn’t have all responses for all requirements inside requirement group:

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "type": "document"
          }
        ],
        "value": "True"
      }
    ]
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "requirementResponses": [
      {
        "title": "Requirement response",
        "description": "some description",
        "requirement": {
          "id": "15d2ba1109184cb695b1d750c8bc5e66",
          "title": "Фізична особа, яка є учасником процедури закупівлі, не була засуджена за злочин, учинений з корисливих мотивів (зокрема, пов'язаний з хабарництвом та відмиванням коштів), судимість з якої знято або погашено у встановленому законом порядку"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "8741413551c146c88cfdfe3a53954314"
          }
        ],
        "value": "True",
        "id": "eff70b5b7db14c2d843be203732d8b53"
      },
      {
        "title": "Requirement response 2",
        "description": "some description",
        "requirement": {
          "id": "1d01dafe931c47d9999088c0f28793f7",
          "title": "Суб'єкт господарювання (учасник) протягом останніх трьох років не притягувався до відповідальності за порушення, передбачене пунктом 4 частини другої статті 6, пунктом 1 статті 50 Закону України \"Про захист економічної конкуренції\", у вигляді вчинення антиконкурентних узгоджених дій, що стосуються спотворення результатів тендерів"
        },
        "evidences": [
          {
            "title": "Requirement response",
            "type": "document",
            "relatedDocument": {
              "id": "3367c62610004e63bc05756d076023cf",
              "title": "name.doc"
            },
            "id": "ac38c63e1722498f806de59ebaff1344"
          }
        ],
        "value": "True",
        "id": "8cdc00f0cca9476b8c96ae690b9992fb"
      }
    ],
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "scale": "micro"
      }
    ],
    "status": "draft",
    "id": "987b40daa8334398a3f222f3fb033be2",
    "date": "2023-10-10T01:00:00+03:00",
    "subcontractingDetails": "ДКП «Орфей», Україна",
    "lotValues": [
      {
        "value": {
          "amount": 500.0,
          "currency": "UAH",
          "valueAddedTaxIncluded": true
        },
        "relatedLot": "ab777668b8ff4f4a82faccf36709dd59",
        "status": "pending",
        "date": "2023-10-10T01:00:00+03:00"
      }
    ],
    "documents": [
      {
        "id": "3367c62610004e63bc05756d076023cf",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "name.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/eca1451a57d142f394808a9f0953822a?Signature=A5icXgC%2BjDHMUEXaX29uygDBZX9J6M9cqFFJ2zo16OfslBgPmX65qOyR9HdbASPCIYc%2Fgu5Rv6JBLxngz5v1Aw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "language": "uk",
        "confidentiality": "public"
      }
    ],
    "selfQualified": true
  }
}

Request

PATCH /api/2.5/tenders/22ce65f78679422981e3ee40eed3ea67/bids/987b40daa8334398a3f222f3fb033be2?acc_token=8a0b1f0e806b43589cebdb9a76747c70 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "pending"
  }
}

Response

HTTP/1.0 422 Unprocessable Entity
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "requirementResponses",
      "description": [
        "Inside requirement group must get answered all of requirements"
      ]
    }
  ]
}

Workflow Requirement Response

Workflow of requirement response you could see here: Criteria Workflow