Claim/Complaint Retrieval

Tender Conditions Claim/Complaint Retrieval

You can list all Tender Conditions Claims/Complaints:

Request

GET /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [
    {
      "id": "b0ca3342dd464a43b104d344564afa80",
      "complaintID": "UA-2023-10-10-000001-a.1",
      "date": "2023-10-10T01:00:00+03:00",
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "status": "resolved",
      "resolution": "Виправлено неконкурентні умови",
      "resolutionType": "resolved",
      "dateAnswered": "2023-10-10T01:00:00+03:00",
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "satisfied": true,
      "type": "claim"
    },
    {
      "id": "8e1c5f88d0474f14a9dc74a76d7e4e07",
      "complaintID": "UA-2023-10-10-000001-a.2",
      "date": "2023-10-10T01:00:00+03:00",
      "status": "declined",
      "documents": [
        {
          "id": "60256d73d83b4148a79aa23e64d74d00",
          "datePublished": "2023-10-10T01:00:00+03:00",
          "hash": "md5:00000000000000000000000000000000",
          "title": "Complaint_Attachment.pdf",
          "format": "application/pdf",
          "url": "http://public-docs-sandbox.prozorro.gov.ua/get/58f9d67e04944faa910186f868189357?Signature=bTyysxLgmSxwOJ2mbeKuyIt9n0Kc0GIDrLYtNInWgPLwFyGb0nhul1wcwlTI5Lh7pZFnS9JPCG0ax9wWPt1LAQ%3D%3D&KeyID=a8968c46",
          "documentOf": "tender",
          "dateModified": "2023-10-10T01:00:00+03:00",
          "author": "complaint_owner",
          "language": "uk"
        }
      ],
      "type": "complaint",
      "author": {
        "name": "ДКП «Школяр»",
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "uri": "http://www.sc.gov.ua/",
          "id": "00137256",
          "legalName": "ДКП «Школяр»"
        }
      },
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "acceptance": true,
      "dateAccepted": "2023-10-10T01:00:00+03:00",
      "reviewDate": "2023-10-10T01:00:00+03:00",
      "reviewPlace": "Place of review",
      "value": {
        "amount": 2000.0,
        "currency": "UAH"
      },
      "dateDecision": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "5a9355a1f73c43d28903b89decf68025",
      "complaintID": "UA-2023-10-10-000001-a.1",
      "date": "2023-10-10T01:00:00+03:00",
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "status": "answered",
      "resolution": "Вимога не відповідає предмету закупівлі",
      "resolutionType": "invalid",
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "type": "claim",
      "dateAnswered": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "379051e428734c148aea805b08e76ff1",
      "complaintID": "UA-2023-10-10-000001-a.4",
      "date": "2023-10-10T01:00:00+03:00",
      "status": "resolved",
      "documents": [
        {
          "id": "37e5b868adb34094805ddfe95cc6d89c",
          "datePublished": "2023-10-10T01:00:00+03:00",
          "hash": "md5:00000000000000000000000000000000",
          "title": "ComplaintResolution.pdf",
          "format": "application/pdf",
          "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e54de546b85a4d67b8d541c624ab6c36?Signature=y2nY0tzn8KyDwg9YuaulyZnCDfozZ7TRTStPKv8qORYijdkzr3rmXQjcF%2FJAzVO06VtH7e%2ByWVWFI1SODaOkAA%3D%3D&KeyID=a8968c46",
          "documentOf": "tender",
          "dateModified": "2023-10-10T01:00:00+03:00",
          "author": "aboveThresholdReviewers",
          "language": "uk"
        }
      ],
      "type": "complaint",
      "author": {
        "name": "ДКП «Школяр»",
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "uri": "http://www.sc.gov.ua/",
          "id": "00137256",
          "legalName": "ДКП «Школяр»"
        }
      },
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "tendererAction": "Умови виправлено",
      "dateDecision": "2023-10-10T01:00:00+03:00",
      "acceptance": true,
      "dateAccepted": "2023-10-10T01:00:00+03:00",
      "reviewDate": "2023-10-10T01:00:00+03:00",
      "reviewPlace": "Place of review",
      "value": {
        "amount": 2000.0,
        "currency": "UAH"
      },
      "tendererActionDate": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "cd2a784c50d54e89944fb36a581a8d41",
      "complaintID": "UA-2023-10-10-000001-a.5",
      "date": "2023-10-10T01:00:00+03:00",
      "status": "stopped",
      "type": "complaint",
      "author": {
        "name": "ДКП «Школяр»",
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "uri": "http://www.sc.gov.ua/",
          "id": "00137256",
          "legalName": "ДКП «Школяр»"
        }
      },
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "decision": "Тендер скасовується замовником",
      "acceptance": true,
      "dateAccepted": "2023-10-10T01:00:00+03:00",
      "reviewDate": "2023-10-10T01:00:00+03:00",
      "reviewPlace": "Place of review",
      "value": {
        "amount": 2000.0,
        "currency": "UAH"
      },
      "rejectReason": "tenderCancelled",
      "dateDecision": "2023-10-10T01:00:00+03:00",
      "dateCanceled": "2023-10-10T01:00:00+03:00"
    },
    {
      "id": "ab69304a77b24e94852d8fdf9d71a19c",
      "complaintID": "UA-2023-10-10-000001-a.6",
      "date": "2023-10-10T01:00:00+03:00",
      "status": "accepted",
      "type": "complaint",
      "author": {
        "name": "ДКП «Школяр»",
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "uri": "http://www.sc.gov.ua/",
          "id": "00137256",
          "legalName": "ДКП «Школяр»"
        }
      },
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "reviewDate": "2023-10-10T01:00:00+03:00",
      "reviewPlace": "Place of review",
      "value": {
        "amount": 2000.0,
        "currency": "UAH"
      },
      "dateAccepted": "2023-10-10T01:00:00+03:00",
      "acceptance": true
    },
    {
      "id": "f9d00a0ce0c0465ebf78a30d2cc101ae",
      "complaintID": "UA-2023-10-10-000001-a.7",
      "date": "2023-10-10T01:00:00+03:00",
      "status": "invalid",
      "type": "complaint",
      "author": {
        "name": "ДКП «Школяр»",
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "uri": "http://www.sc.gov.ua/",
          "id": "00137256",
          "legalName": "ДКП «Школяр»"
        }
      },
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "value": {
        "amount": 2000.0,
        "currency": "UAH"
      },
      "rejectReason": "alreadyExists",
      "dateDecision": "2023-10-10T01:00:00+03:00",
      "acceptance": false
    },
    {
      "id": "29bf9179dce0424db116e98436b4adb4",
      "complaintID": "UA-2023-10-10-000001-a.8",
      "date": "2023-10-10T01:00:00+03:00",
      "status": "mistaken",
      "type": "complaint",
      "author": {
        "name": "ДКП «Школяр»",
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "uri": "http://www.sc.gov.ua/",
          "id": "00137256",
          "legalName": "ДКП «Школяр»"
        }
      },
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "value": {
        "amount": 2000.0,
        "currency": "UAH"
      },
      "rejectReason": "cancelledByComplainant"
    },
    {
      "id": "3131116986bb4f24a6bc60bd8b2b0b24",
      "complaintID": "UA-2023-10-10-000001-a.9",
      "date": "2023-10-10T01:00:00+03:00",
      "status": "pending",
      "type": "complaint",
      "author": {
        "name": "ДКП «Школяр»",
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "uri": "http://www.sc.gov.ua/",
          "id": "00137256",
          "legalName": "ДКП «Школяр»"
        }
      },
      "title": "Недостатньо інформації",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "value": {
        "amount": 2000.0,
        "currency": "UAH"
      },
      "dateSubmitted": "2023-10-10T01:00:00+03:00",
      "posts": [
        {
          "title": "Уточнення по вимозі",
          "description": "Відсутній документ",
          "recipient": "complaint_owner",
          "id": "1464868655a9403ca945d3d6c748cb22",
          "datePublished": "2023-10-10T01:00:00+03:00",
          "author": "aboveThresholdReviewers"
        },
        {
          "title": "Уточнення по вимозі",
          "description": "Додано документ",
          "documents": [
            {
              "hash": "md5:00000000000000000000000000000000",
              "title": "post_document_complaint.pdf",
              "format": "application/pdf",
              "url": "http://public-docs-sandbox.prozorro.gov.ua/get/842a382f56354d5ebbe08b7dec07d46a?Signature=G0g69DxjEzmE0ZAZ%2B7S9WCAUVZGW3qDS%2F8TpeiMk3jOebuAd%2FKG9FQkkTNhDsFQogV30qRU54gOiuy5jtqW7AQ%3D%3D&KeyID=a8968c46",
              "documentOf": "tender",
              "language": "uk",
              "id": "ad3e359c01004723a34c284be0858323",
              "datePublished": "2023-10-10T01:00:00+03:00",
              "dateModified": "2023-10-10T01:00:00+03:00",
              "author": "complaint_owner"
            }
          ],
          "recipient": "aboveThresholdReviewers",
          "relatedPost": "1464868655a9403ca945d3d6c748cb22",
          "id": "13b1c47a2ae74e1ab7ab8c07b96b9f0c",
          "datePublished": "2023-10-10T01:00:00+03:00",
          "author": "complaint_owner"
        },
        {
          "title": "Уточнення по вимозі",
          "description": "Відсутній документ",
          "recipient": "tender_owner",
          "id": "83d9848c51594e758f9f0b771200bbf0",
          "datePublished": "2023-10-10T01:00:00+03:00",
          "author": "aboveThresholdReviewers"
        },
        {
          "title": "Уточнення по вимозі",
          "description": "Додано документ",
          "documents": [
            {
              "hash": "md5:00000000000000000000000000000000",
              "title": "post_document_tender.pdf",
              "format": "application/pdf",
              "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3a4ed86d11e9460393a63047c5920470?Signature=WtEhYfcozcKWsGWJ%2BuMeQe6hsm9eBGS%2BDJdVJ2BZzsvEtkiuktiRt0OtWrvVlPpLRPyoOMyYmXJXw5DcphfPAw%3D%3D&KeyID=a8968c46",
              "documentOf": "tender",
              "language": "uk",
              "id": "d6e4eec1f7474f7dab279ddcfc29e29a",
              "datePublished": "2023-10-10T01:00:00+03:00",
              "dateModified": "2023-10-10T01:00:00+03:00",
              "author": "tender_owner"
            }
          ],
          "recipient": "aboveThresholdReviewers",
          "relatedPost": "83d9848c51594e758f9f0b771200bbf0",
          "id": "53ba68c7dbde471bb0f2e2a445e87077",
          "datePublished": "2023-10-10T01:00:00+03:00",
          "author": "tender_owner"
        }
      ]
    }
  ]
}

And check individual complaint or claim:

Request

GET /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "id": "379051e428734c148aea805b08e76ff1",
    "complaintID": "UA-2023-10-10-000001-a.4",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "resolved",
    "documents": [
      {
        "id": "37e5b868adb34094805ddfe95cc6d89c",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "ComplaintResolution.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e54de546b85a4d67b8d541c624ab6c36?Signature=y2nY0tzn8KyDwg9YuaulyZnCDfozZ7TRTStPKv8qORYijdkzr3rmXQjcF%2FJAzVO06VtH7e%2ByWVWFI1SODaOkAA%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "aboveThresholdReviewers",
        "language": "uk"
      }
    ],
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "dateSubmitted": "2023-10-10T01:00:00+03:00",
    "tendererAction": "Умови виправлено",
    "dateDecision": "2023-10-10T01:00:00+03:00",
    "acceptance": true,
    "dateAccepted": "2023-10-10T01:00:00+03:00",
    "reviewDate": "2023-10-10T01:00:00+03:00",
    "reviewPlace": "Place of review",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "tendererActionDate": "2023-10-10T01:00:00+03:00"
  }
}

Complaint Submission

If tender conditions are favoriting particular supplier, or in any other viable case, any registered user can submit Tender Conditions Complaint.

Tender Conditions Complaint Submission

At first create a draft:

Request

POST /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "status": "draft",
    "type": "complaint",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Вінниця",
        "postalCode": "21100",
        "region": "Вінницька область",
        "streetAddress": "вул. Островського, 33"
      },
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "name": "Сергій Олексюк",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "ДКП «Школяр»",
        "id": "00137256",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Школяр»"
    }
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1

{
  "data": {
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "status": "draft",
    "type": "complaint",
    "id": "379051e428734c148aea805b08e76ff1",
    "date": "2023-10-10T01:00:00+03:00",
    "complaintID": "UA-2023-10-10-000001-a.4",
    "value": {
      "amount": 2000,
      "currency": "UAH"
    }
  },
  "access": {
    "token": "c328a958334844f29c7f9a85bd0a890d",
    "transfer": "6bcb0e29831d44fc99f6f48384d04338"
  }
}

This step is optional. Upload documents:

Request

POST /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/8e1c5f88d0474f14a9dc74a76d7e4e07/documents?acc_token=80efaaf6eeb64665a7967df0af8e6fa3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Complaint_Attachment.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/58f9d67e04944faa910186f868189357?Signature=Sz4Mq5QzxrCbk4fmeuhIXV8%2FKQxjBpJVpeU77IlUm7%2BxOH02lPTaDOeqjTVGMCRIac4S1I%2BEkhBJCH1omlJtCw%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/8e1c5f88d0474f14a9dc74a76d7e4e07/documents/60256d73d83b4148a79aa23e64d74d00

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Complaint_Attachment.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/58f9d67e04944faa910186f868189357?Signature=bTyysxLgmSxwOJ2mbeKuyIt9n0Kc0GIDrLYtNInWgPLwFyGb0nhul1wcwlTI5Lh7pZFnS9JPCG0ax9wWPt1LAQ%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "60256d73d83b4148a79aa23e64d74d00",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "complaint_owner"
  }
}

Submit tender conditions complaint:

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1 HTTP/1.0
Authorization: Bearer bot
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

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

Response

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

{
  "data": {
    "id": "379051e428734c148aea805b08e76ff1",
    "complaintID": "UA-2023-10-10-000001-a.4",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "pending",
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "dateSubmitted": "2023-10-10T01:00:00+03:00"
  }
}

Complaint Objections

When creating a complaint, the User can add one or more Objections raised by the Complainant as part of the complaint:

Request

POST /api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "status": "draft",
    "type": "complaint",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Вінниця",
        "postalCode": "21100",
        "region": "Вінницька область",
        "streetAddress": "вул. Островського, 33"
      },
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "name": "Сергій Олексюк",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "ДКП «Школяр»",
        "id": "00137256",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Школяр»"
    },
    "objections": [
      {
        "title": "My objection",
        "description": "Test objection",
        "relatesTo": "tender",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "description": "test",
            "type": "setAsideAward"
          }
        ],
        "arguments": [
          {
            "description": "test argument"
          }
        ]
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints/e806d85cfc5246529033610d17f40f6b

{
  "data": {
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "status": "draft",
    "type": "complaint",
    "objections": [
      {
        "id": "7b4c8b5700f947e680df5800f0c15194",
        "title": "My objection",
        "description": "Test objection",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "id": "345b9f00ab4c4bc2b58961a489b79bf8",
            "type": "setAsideAward",
            "description": "test"
          }
        ],
        "arguments": [
          {
            "id": "3179cbd9e0ec4e2a97b843b2d4a8895f",
            "description": "test argument"
          }
        ],
        "relatesTo": "tender"
      }
    ],
    "id": "e806d85cfc5246529033610d17f40f6b",
    "date": "2023-10-10T01:00:00+03:00",
    "complaintID": "UA-2023-10-10-000001-a.1",
    "value": {
      "amount": 2000,
      "currency": "UAH"
    }
  },
  "access": {
    "token": "2dfdae41bcc446b19fb748517acea5cc",
    "transfer": "d0544c28c72547539018ae924f90b1bb"
  }
}

Objections can be added or edited while complaint is in the status draft.

For each Objection, the Complainant must indicate one or more arguments. In other case there error will be raised:

Request

POST /api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "status": "draft",
    "type": "complaint",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Вінниця",
        "postalCode": "21100",
        "region": "Вінницька область",
        "streetAddress": "вул. Островського, 33"
      },
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "name": "Сергій Олексюк",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "ДКП «Школяр»",
        "id": "00137256",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Школяр»"
    },
    "objections": [
      {
        "title": "My objection",
        "description": "Test objection",
        "relatesTo": "tender",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "description": "test",
            "type": "setAsideAward"
          }
        ],
        "arguments": []
      }
    ]
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "objections",
      "description": [
        {
          "arguments": [
            "Please provide at least 1 item."
          ]
        }
      ]
    }
  ]
}

For each Arguments, the Complainant can indicate one or more evidences. Evidences can be empty:

Request

POST /api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "status": "draft",
    "type": "complaint",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Вінниця",
        "postalCode": "21100",
        "region": "Вінницька область",
        "streetAddress": "вул. Островського, 33"
      },
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "name": "Сергій Олексюк",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "ДКП «Школяр»",
        "id": "00137256",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Школяр»"
    },
    "objections": [
      {
        "title": "My objection",
        "description": "Test objection",
        "relatesTo": "tender",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "description": "test",
            "type": "setAsideAward"
          }
        ],
        "arguments": [
          {
            "description": "test argument",
            "evidences": []
          }
        ]
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints/accadb05292e48679b52c49abc1b7194

{
  "data": {
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "status": "draft",
    "type": "complaint",
    "objections": [
      {
        "id": "ae731fe27f904e038913c411b3673dc4",
        "title": "My objection",
        "description": "Test objection",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "id": "6ff1b74fad2d41e39e1115d1f0f0ec3d",
            "type": "setAsideAward",
            "description": "test"
          }
        ],
        "arguments": [
          {
            "id": "11c8d7c71b0748b89093ee4e4257294f",
            "description": "test argument"
          }
        ],
        "relatesTo": "tender"
      }
    ],
    "id": "accadb05292e48679b52c49abc1b7194",
    "date": "2023-10-10T01:00:00+03:00",
    "complaintID": "UA-2023-10-10-000001-a.2",
    "value": {
      "amount": 2000,
      "currency": "UAH"
    }
  },
  "access": {
    "token": "3249b93eba9d4119831a7f3708450101",
    "transfer": "40c4750b03014bae8856d3cd959eb075"
  }
}

During adding evidence, the User must indicate related document id. This document should be uploaded to complaint. Let’s upload document to complaint:

Request

POST /api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints/accadb05292e48679b52c49abc1b7194/documents?acc_token=3249b93eba9d4119831a7f3708450101 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Evidence_Attachment.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b26be5ae7c34fba94a90ded82ea8f77?Signature=0IdXIJEOEGO6woNI4j%2BghPe5wvrSKSO%2BC8QhuS%2BfzZVFQUykS1ErsD4ff6KaTyPnyeWEXKhts%2BwoxJr6XfrwAA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints/accadb05292e48679b52c49abc1b7194/documents/5ecf6d2d17c44d0c8e63bd27cfb42afd

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Evidence_Attachment.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b26be5ae7c34fba94a90ded82ea8f77?Signature=BUNzCuzNDxlsQErN6J%2BpEczxECckQ3X21eWWljMmudrqUDGMOXlyLAhh%2BAWSFauQxp8nprIF%2FJtKWUBHtSVICw%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "5ecf6d2d17c44d0c8e63bd27cfb42afd",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "complaint_owner"
  }
}

After that User can indicate relatedDocument in evidence:

Request

PATCH /api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints/accadb05292e48679b52c49abc1b7194?acc_token=3249b93eba9d4119831a7f3708450101 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "objections": [
      {
        "title": "My objection",
        "description": "Test objection",
        "relatesTo": "tender",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "description": "test",
            "type": "setAsideAward"
          }
        ],
        "arguments": [
          {
            "description": "test argument",
            "evidences": [
              {
                "title": "Evidence",
                "description": "Test evidence",
                "relatedDocument": "5ecf6d2d17c44d0c8e63bd27cfb42afd"
              }
            ]
          }
        ],
        "id": "ae731fe27f904e038913c411b3673dc4"
      }
    ]
  }
}

Response

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

{
  "data": {
    "id": "accadb05292e48679b52c49abc1b7194",
    "complaintID": "UA-2023-10-10-000001-a.2",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "draft",
    "documents": [
      {
        "id": "5ecf6d2d17c44d0c8e63bd27cfb42afd",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Evidence_Attachment.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/7b26be5ae7c34fba94a90ded82ea8f77?Signature=BUNzCuzNDxlsQErN6J%2BpEczxECckQ3X21eWWljMmudrqUDGMOXlyLAhh%2BAWSFauQxp8nprIF%2FJtKWUBHtSVICw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "complaint_owner",
        "language": "uk"
      }
    ],
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "objections": [
      {
        "id": "ae731fe27f904e038913c411b3673dc4",
        "title": "My objection",
        "description": "Test objection",
        "relatesTo": "tender",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "id": "fe334c75f9fe4624960647a13574c8f1",
            "type": "setAsideAward",
            "description": "test"
          }
        ],
        "arguments": [
          {
            "id": "2608e55af0134ed69b6fe40980ff1643",
            "description": "test argument",
            "evidences": [
              {
                "id": "73eab58ffa9f4ddaa157e36bee57204b",
                "title": "Evidence",
                "description": "Test evidence",
                "relatedDocument": "5ecf6d2d17c44d0c8e63bd27cfb42afd"
              }
            ]
          }
        ]
      }
    ],
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    }
  }
}

There is an opportunity to create complaint already with document which can be used as relatedDocument in evidences:

Request

POST /api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "status": "draft",
    "type": "complaint",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Вінниця",
        "postalCode": "21100",
        "region": "Вінницька область",
        "streetAddress": "вул. Островського, 33"
      },
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "name": "Сергій Олексюк",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "ДКП «Школяр»",
        "id": "00137256",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Школяр»"
    },
    "objections": [
      {
        "title": "My objection",
        "description": "Test objection",
        "relatesTo": "tender",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "description": "test",
            "type": "setAsideAward"
          }
        ],
        "arguments": [
          {
            "description": "test argument",
            "evidences": [
              {
                "title": "Evidence",
                "description": "Test evidence",
                "relatedDocument": "22e48e4e4a834e79b06761fe00e6e42d"
              }
            ]
          }
        ]
      }
    ],
    "documents": [
      {
        "id": "22e48e4e4a834e79b06761fe00e6e42d",
        "title": "Evidence_Attachment.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6a9bf350d9d94ede9932f4915ce1821f?Signature=jWUP3NcCxCgoDjMrZDhTt%2BgD1%2B%2FYvyv73uCy8UVRIO%2BA44TOWOHLxMkQyMWO6dmlmxg%2FkactsWtfh1K4VhkLAg%3D%3D&KeyID=a8968c46",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints/b265f5154e324ed88f04c1c2f343fb51

{
  "data": {
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "status": "draft",
    "type": "complaint",
    "objections": [
      {
        "id": "82b22f08092e44559b6730d39209fbf7",
        "title": "My objection",
        "description": "Test objection",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [
          {
            "id": "b52c92979c224938a82ef0d054106fce",
            "type": "setAsideAward",
            "description": "test"
          }
        ],
        "arguments": [
          {
            "id": "364a8c0107344de693aa776ec538f742",
            "description": "test argument",
            "evidences": [
              {
                "id": "b2b1f40126144152825a2998a654ab94",
                "title": "Evidence",
                "description": "Test evidence",
                "relatedDocument": "22e48e4e4a834e79b06761fe00e6e42d"
              }
            ]
          }
        ],
        "relatesTo": "tender"
      }
    ],
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "Evidence_Attachment.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/6a9bf350d9d94ede9932f4915ce1821f?Signature=gZeJXrTEIJJQ4JEAASlh9neb55COU71qGQCQ8ifLRd8kN6ZRk9YLkOGjgm4s4QQ%2Fel36kP%2BKw5jHgy0EfZTDAw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "language": "uk",
        "id": "22e48e4e4a834e79b06761fe00e6e42d",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "complaint_owner"
      }
    ],
    "id": "b265f5154e324ed88f04c1c2f343fb51",
    "date": "2023-10-10T01:00:00+03:00",
    "complaintID": "UA-2023-10-10-000001-a.3",
    "value": {
      "amount": 2000,
      "currency": "UAH"
    }
  },
  "access": {
    "token": "a4e7fad4785c4844941bc64b490c3693",
    "transfer": "5c8878df4ab040459093446550039989"
  }
}

For each Objection, the Complainant must specify one or more requestedRemedies. In other case there error will be raised:

Request

POST /api/2.5/tenders/b1b9e2275509420b8a3759c55a76d2cc/complaints HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "status": "draft",
    "type": "complaint",
    "author": {
      "address": {
        "countryName": "Україна",
        "locality": "м. Вінниця",
        "postalCode": "21100",
        "region": "Вінницька область",
        "streetAddress": "вул. Островського, 33"
      },
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "name": "Сергій Олексюк",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "ДКП «Школяр»",
        "id": "00137256",
        "uri": "http://www.sc.gov.ua/"
      },
      "name": "ДКП «Школяр»"
    },
    "objections": [
      {
        "title": "My objection",
        "description": "Test objection",
        "relatesTo": "tender",
        "relatedItem": "b1b9e2275509420b8a3759c55a76d2cc",
        "classification": {
          "scheme": "violation_amcu",
          "id": "corruptionDescription",
          "description": "test classification"
        },
        "requestedRemedies": [],
        "arguments": [
          {
            "description": "test argument"
          }
        ]
      }
    ]
  }
}

Response

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

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "objections",
      "description": [
        {
          "requestedRemedies": [
            "Please provide at least 1 item."
          ]
        }
      ]
    }
  ]
}

Complaint Posts

Once complaint is in pending or accepted status reviewer can submit a post to complaint.

Tender Conditions Complaint Posts (with complaint owner)

Reviewer can submit a post to complaint owner:

Request

POST /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Відсутній документ",
    "recipient": "complaint_owner"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts/1464868655a9403ca945d3d6c748cb22

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Відсутній документ",
    "recipient": "complaint_owner",
    "id": "1464868655a9403ca945d3d6c748cb22",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "author": "aboveThresholdReviewers"
  }
}

Complaint owner can submit a reply post to reviewer by setting reviewer’s post id as relatedPost:

Request

POST /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts?acc_token=e3de4cad10924527927b751b1ceeae1b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Додано документ",
    "recipient": "aboveThresholdReviewers",
    "relatedPost": "1464868655a9403ca945d3d6c748cb22",
    "documents": [
      {
        "title": "post_document_complaint.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/842a382f56354d5ebbe08b7dec07d46a?Signature=kI2bMfs5yvKEz9X2%2FQvltWVwqstO4RL3BOo9YBH2hh7xrw30Y58YfnMS0b39iNhheUaB9PF9WUofGzjciV%2FSBQ%3D%3D&KeyID=a8968c46",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts/13b1c47a2ae74e1ab7ab8c07b96b9f0c

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Додано документ",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "post_document_complaint.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/842a382f56354d5ebbe08b7dec07d46a?Signature=G0g69DxjEzmE0ZAZ%2B7S9WCAUVZGW3qDS%2F8TpeiMk3jOebuAd%2FKG9FQkkTNhDsFQogV30qRU54gOiuy5jtqW7AQ%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "language": "uk",
        "id": "ad3e359c01004723a34c284be0858323",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "complaint_owner"
      }
    ],
    "recipient": "aboveThresholdReviewers",
    "relatedPost": "1464868655a9403ca945d3d6c748cb22",
    "id": "13b1c47a2ae74e1ab7ab8c07b96b9f0c",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "author": "complaint_owner"
  }
}

Tender Conditions Complaint Posts (with tender owner)

Reviewer can submit a post to tender owner:

Request

POST /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Відсутній документ",
    "recipient": "tender_owner"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts/83d9848c51594e758f9f0b771200bbf0

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Відсутній документ",
    "recipient": "tender_owner",
    "id": "83d9848c51594e758f9f0b771200bbf0",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "author": "aboveThresholdReviewers"
  }
}

Tender owner can submit a reply post to reviewer by setting reviewer’s post id as relatedPost:

Request

POST /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts?acc_token=1589d5502f3b4b24b31d29b42c14f3f3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Додано документ",
    "recipient": "aboveThresholdReviewers",
    "relatedPost": "83d9848c51594e758f9f0b771200bbf0",
    "documents": [
      {
        "title": "post_document_tender.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3a4ed86d11e9460393a63047c5920470?Signature=7eGLB2nF6sAp%2BMd80eVuecZD%2F8VJ%2FKdxOac8YUuOMjKLBumfPLbYrxiosIbIYneIslZ4ipavWS5rBfoTgI4kBQ%3D%3D&KeyID=a8968c46",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf"
      }
    ]
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/3131116986bb4f24a6bc60bd8b2b0b24/posts/53ba68c7dbde471bb0f2e2a445e87077

{
  "data": {
    "title": "Уточнення по вимозі",
    "description": "Додано документ",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "post_document_tender.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3a4ed86d11e9460393a63047c5920470?Signature=WtEhYfcozcKWsGWJ%2BuMeQe6hsm9eBGS%2BDJdVJ2BZzsvEtkiuktiRt0OtWrvVlPpLRPyoOMyYmXJXw5DcphfPAw%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "language": "uk",
        "id": "d6e4eec1f7474f7dab279ddcfc29e29a",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "tender_owner"
      }
    ],
    "recipient": "aboveThresholdReviewers",
    "relatedPost": "83d9848c51594e758f9f0b771200bbf0",
    "id": "53ba68c7dbde471bb0f2e2a445e87077",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "author": "tender_owner"
  }
}

Complaint Resolution

Rejecting Tender Conditions Complaint

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/f9d00a0ce0c0465ebf78a30d2cc101ae HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "invalid",
    "rejectReason": "alreadyExists"
  }
}

Response

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

{
  "data": {
    "id": "f9d00a0ce0c0465ebf78a30d2cc101ae",
    "complaintID": "UA-2023-10-10-000001-a.7",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "invalid",
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "dateSubmitted": "2023-10-10T01:00:00+03:00",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "rejectReason": "alreadyExists",
    "dateDecision": "2023-10-10T01:00:00+03:00",
    "acceptance": false
  }
}

Accepting Tender Conditions Complaint

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1 HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "accepted",
    "reviewDate": "2023-10-10T01:00:00+03:00",
    "reviewPlace": "Place of review"
  }
}

Response

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

{
  "data": {
    "id": "379051e428734c148aea805b08e76ff1",
    "complaintID": "UA-2023-10-10-000001-a.4",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "accepted",
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "dateSubmitted": "2023-10-10T01:00:00+03:00",
    "reviewDate": "2023-10-10T01:00:00+03:00",
    "reviewPlace": "Place of review",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "dateAccepted": "2023-10-10T01:00:00+03:00",
    "acceptance": true
  }
}

Submitting Tender Conditions Complaint Resolution

The Complaint Review Body uploads the resolution document:

Request

POST /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1/documents HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "title": "ComplaintResolution.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e54de546b85a4d67b8d541c624ab6c36?Signature=Bjcp2stkTCPXJh0jeFm7xcjO%2Bd1YXOA%2FYd5hDmZmtBoaVP1mzvOGuZWSAIaXjvwvkRWU%2FVrDz4g3pZOVW6REDw%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1/documents/37e5b868adb34094805ddfe95cc6d89c

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "ComplaintResolution.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e54de546b85a4d67b8d541c624ab6c36?Signature=y2nY0tzn8KyDwg9YuaulyZnCDfozZ7TRTStPKv8qORYijdkzr3rmXQjcF%2FJAzVO06VtH7e%2ByWVWFI1SODaOkAA%3D%3D&KeyID=a8968c46",
    "documentOf": "tender",
    "language": "uk",
    "id": "37e5b868adb34094805ddfe95cc6d89c",
    "datePublished": "2023-10-10T01:00:00+03:00",
    "dateModified": "2023-10-10T01:00:00+03:00",
    "author": "aboveThresholdReviewers"
  }
}

And either resolves complaint:

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1 HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "satisfied"
  }
}

Response

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

{
  "data": {
    "id": "379051e428734c148aea805b08e76ff1",
    "complaintID": "UA-2023-10-10-000001-a.4",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "satisfied",
    "documents": [
      {
        "id": "37e5b868adb34094805ddfe95cc6d89c",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "ComplaintResolution.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e54de546b85a4d67b8d541c624ab6c36?Signature=y2nY0tzn8KyDwg9YuaulyZnCDfozZ7TRTStPKv8qORYijdkzr3rmXQjcF%2FJAzVO06VtH7e%2ByWVWFI1SODaOkAA%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "aboveThresholdReviewers",
        "language": "uk"
      }
    ],
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "dateSubmitted": "2023-10-10T01:00:00+03:00",
    "acceptance": true,
    "dateAccepted": "2023-10-10T01:00:00+03:00",
    "reviewDate": "2023-10-10T01:00:00+03:00",
    "reviewPlace": "Place of review",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "dateDecision": "2023-10-10T01:00:00+03:00"
  }
}

Or declines it:

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/8e1c5f88d0474f14a9dc74a76d7e4e07 HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "declined"
  }
}

Response

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

{
  "data": {
    "id": "8e1c5f88d0474f14a9dc74a76d7e4e07",
    "complaintID": "UA-2023-10-10-000001-a.2",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "declined",
    "documents": [
      {
        "id": "60256d73d83b4148a79aa23e64d74d00",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "Complaint_Attachment.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/58f9d67e04944faa910186f868189357?Signature=bTyysxLgmSxwOJ2mbeKuyIt9n0Kc0GIDrLYtNInWgPLwFyGb0nhul1wcwlTI5Lh7pZFnS9JPCG0ax9wWPt1LAQ%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "complaint_owner",
        "language": "uk"
      }
    ],
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "dateSubmitted": "2023-10-10T01:00:00+03:00",
    "acceptance": true,
    "dateAccepted": "2023-10-10T01:00:00+03:00",
    "reviewDate": "2023-10-10T01:00:00+03:00",
    "reviewPlace": "Place of review",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "dateDecision": "2023-10-10T01:00:00+03:00"
  }
}

Submitting Resolution Confirmation

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/379051e428734c148aea805b08e76ff1?acc_token=1589d5502f3b4b24b31d29b42c14f3f3 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tendererAction": "Умови виправлено",
    "status": "resolved"
  }
}

Response

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

{
  "data": {
    "id": "379051e428734c148aea805b08e76ff1",
    "complaintID": "UA-2023-10-10-000001-a.4",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "resolved",
    "documents": [
      {
        "id": "37e5b868adb34094805ddfe95cc6d89c",
        "datePublished": "2023-10-10T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "ComplaintResolution.pdf",
        "format": "application/pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e54de546b85a4d67b8d541c624ab6c36?Signature=y2nY0tzn8KyDwg9YuaulyZnCDfozZ7TRTStPKv8qORYijdkzr3rmXQjcF%2FJAzVO06VtH7e%2ByWVWFI1SODaOkAA%3D%3D&KeyID=a8968c46",
        "documentOf": "tender",
        "dateModified": "2023-10-10T01:00:00+03:00",
        "author": "aboveThresholdReviewers",
        "language": "uk"
      }
    ],
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "dateSubmitted": "2023-10-10T01:00:00+03:00",
    "tendererAction": "Умови виправлено",
    "dateDecision": "2023-10-10T01:00:00+03:00",
    "acceptance": true,
    "dateAccepted": "2023-10-10T01:00:00+03:00",
    "reviewDate": "2023-10-10T01:00:00+03:00",
    "reviewPlace": "Place of review",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "tendererActionDate": "2023-10-10T01:00:00+03:00"
  }
}

Cancelling Tender Conditions Complaint

Cancelling draft complaint by Complainant

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/29bf9179dce0424db116e98436b4adb4?acc_token=a0c4c5491f78444ba34860fd9142829b HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "mistaken"
  }
}

Response

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

{
  "data": {
    "id": "29bf9179dce0424db116e98436b4adb4",
    "complaintID": "UA-2023-10-10-000001-a.8",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "mistaken",
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "rejectReason": "cancelledByComplainant"
  }
}

Cancelling accepted complaint by Reviewer

Request

PATCH /api/2.5/tenders/2a71069de9654c5ca67c8db208720fe2/complaints/cd2a784c50d54e89944fb36a581a8d41 HTTP/1.0
Authorization: Bearer reviewer
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "decision": "Тендер скасовується замовником",
    "status": "stopped",
    "rejectReason": "tenderCancelled"
  }
}

Response

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

{
  "data": {
    "id": "cd2a784c50d54e89944fb36a581a8d41",
    "complaintID": "UA-2023-10-10-000001-a.5",
    "date": "2023-10-10T01:00:00+03:00",
    "status": "stopped",
    "type": "complaint",
    "author": {
      "name": "ДКП «Школяр»",
      "address": {
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця",
        "region": "Вінницька область",
        "postalCode": "21100",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com",
        "telephone": "+380432216930"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "uri": "http://www.sc.gov.ua/",
        "id": "00137256",
        "legalName": "ДКП «Школяр»"
      }
    },
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "dateSubmitted": "2023-10-10T01:00:00+03:00",
    "decision": "Тендер скасовується замовником",
    "acceptance": true,
    "dateAccepted": "2023-10-10T01:00:00+03:00",
    "reviewDate": "2023-10-10T01:00:00+03:00",
    "reviewPlace": "Place of review",
    "value": {
      "amount": 2000.0,
      "currency": "UAH"
    },
    "rejectReason": "tenderCancelled",
    "dateDecision": "2023-10-10T01:00:00+03:00",
    "dateCanceled": "2023-10-10T01:00:00+03:00"
  }
}