Violation Reports Tutorial
Post a violation report
You create it from a contract. All the documents are posted along with the data
Request
POST /contracts/88888888444455556666000000000001/violation_reports HTTP/1.0
Authorization: Bearer broker
{
"data": {
"details": {
"reason": "contractBreach",
"description": "Постачальник порушив контракт.",
"documents": [
{
"title": "evidences.doc",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000004?Signature=tugyM7kLI9EeApkIpbgvJ2bIe6pY2C8HGZ0B4zsU6AB33DmdpAdaHMKCXUzNhxcCyults0aRC2hrxYFHe0%2FGBA%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"documentType": "violationReportEvidence"
}
]
}
}
}
Response
HTTP/1.0 201 Created
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000005
Content-Length: 2304
{
"data": {
"details": {
"reason": "contractBreach",
"description": "Постачальник порушив контракт.",
"documents": [
{
"id": "88888888444455556666000000000006",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/documents/88888888444455556666000000000006?download=88888888444455556666000000000004",
"dateModified": "2025-10-12T15:35:35+03:00",
"datePublished": "2025-10-12T15:35:35+03:00",
"documentType": "violationReportEvidence",
"title": "evidences.doc",
"format": "application/msword",
"language": "uk"
}
],
"dateModified": "2025-10-12T15:35:35+03:00"
},
"id": "UA-2025-10-12-000001",
"status": "draft",
"tender_id": "88888888444455556666000000000002",
"contract_id": "88888888444455556666000000000001",
"dateCreated": "2025-10-12T15:35:35+03:00",
"dateModified": "2025-10-12T15:35:35+03:00",
"author": {
"name": "Adam Bryan",
"identifier": {
"id": "534962516",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "298 Michael Street Apt. 869",
"postalCode": "66552",
"countryName": "Chad",
"addressDetails": {}
},
"contactPoint": {
"name": "Nathan Lee",
"email": "marc75@example.org",
"telephone": "560.702.9241x61926",
"faxNumber": "8314738249",
"url": "http://www.lucero-collier.com/"
},
"kind": "general",
"signerInfo": {}
},
"defendants": [
{
"name": "Hannah Peterson",
"identifier": {
"id": "500071620",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "81790 Connie Islands Suite 835",
"postalCode": "87381",
"countryName": "Qatar",
"addressDetails": {}
},
"contactPoint": {
"name": "Chase Simpson",
"email": "jerry22@example.com",
"telephone": "(381)680-2072",
"faxNumber": "461.576.2320x55262",
"url": "https://wilson-schneider.com/"
},
"scale": "large",
"signerInfo": {}
}
],
"authority": {
"name": "Chad Shannon",
"identifier": {
"id": "942880460",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "891 Eric Station Apt. 475",
"postalCode": "53164",
"countryName": "Gambia",
"addressDetails": {}
},
"contactPoint": {
"name": "Dennis Mclaughlin",
"email": "cwilliams@example.org",
"telephone": "852.901.0193",
"faxNumber": "(645)734-5619",
"url": "http://martin.com/"
},
"kind": "central"
}
}
}
While in draft state, it can be changed
Request
PATCH /violation_reports/UA-2025-10-12-000001 HTTP/1.0
Authorization: Bearer broker
{
"data": {
"details": {
"reason": "goodsNonCompliance",
"description": "Якість товару не відповідає нормі."
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000007
Content-Length: 2220
{
"data": {
"details": {
"reason": "goodsNonCompliance",
"description": "Якість товару не відповідає нормі.",
"documents": [
{
"id": "88888888444455556666000000000006",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/documents/88888888444455556666000000000006?download=88888888444455556666000000000004",
"dateModified": "2025-10-12T15:35:35+03:00",
"datePublished": "2025-10-12T15:35:35+03:00",
"documentType": "violationReportEvidence",
"title": "evidences.doc",
"format": "application/msword",
"language": "uk"
}
],
"dateModified": "2025-10-12T15:36:05+03:00"
},
"id": "UA-2025-10-12-000001",
"status": "draft",
"tender_id": "88888888444455556666000000000002",
"contract_id": "88888888444455556666000000000001",
"dateCreated": "2025-10-12T15:35:35+03:00",
"dateModified": "2025-10-12T15:35:35+03:00",
"author": {
"name": "Adam Bryan",
"identifier": {
"id": "534962516",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "298 Michael Street Apt. 869",
"postalCode": "66552",
"countryName": "Chad"
},
"contactPoint": {
"name": "Nathan Lee",
"email": "marc75@example.org",
"telephone": "560.702.9241x61926",
"faxNumber": "8314738249",
"url": "http://www.lucero-collier.com/"
},
"kind": "general"
},
"defendants": [
{
"name": "Hannah Peterson",
"identifier": {
"id": "500071620",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "81790 Connie Islands Suite 835",
"postalCode": "87381",
"countryName": "Qatar"
},
"contactPoint": {
"name": "Chase Simpson",
"email": "jerry22@example.com",
"telephone": "(381)680-2072",
"faxNumber": "461.576.2320x55262",
"url": "https://wilson-schneider.com/"
},
"scale": "large"
}
],
"authority": {
"name": "Chad Shannon",
"identifier": {
"id": "942880460",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "891 Eric Station Apt. 475",
"postalCode": "53164",
"countryName": "Gambia"
},
"contactPoint": {
"name": "Dennis Mclaughlin",
"email": "cwilliams@example.org",
"telephone": "852.901.0193",
"faxNumber": "(645)734-5619",
"url": "http://martin.com/"
},
"kind": "central"
}
}
}
You can delete a document
Request
DELETE /violation_reports/UA-2025-10-12-000001/details/documents/88888888444455556666000000000006 HTTP/1.0
Authorization: Bearer broker
Response
HTTP/1.0 204 No Content
X-Request-ID: 88888888-4444-5555-6666-000000000008
Then post a new one
Request
POST /violation_reports/UA-2025-10-12-000001/details/documents HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "evidence_document_2.pdf",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000009?Signature=m9Z53vY%2FdQRcmsM%2BEtois7GM8zSdQ9d1jsUxXh1qBlSVh%2FLQ6RL4q4CbPh9phIh4ByGt2TBgicd0IzIXlsmNAQ%3D%3D&KeyID=a8968c46",
"hash": "md5:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"format": "application/pdf",
"documentType": "violationReportEvidence"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000000a
Content-Length: 505
{
"data": {
"id": "8888888844445555666600000000000b",
"hash": "md5:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/8888888844445555666600000000000b?download=88888888444455556666000000000009",
"dateModified": "2025-10-12T15:36:35+03:00",
"datePublished": "2025-10-12T15:36:35+03:00",
"documentType": "violationReportEvidence",
"title": "evidence_document_2.pdf",
"format": "application/pdf",
"language": "uk"
}
}
Or you can update document version with PUT method
Request
PUT /violation_reports/UA-2025-10-12-000001/details/documents/8888888844445555666600000000000b HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "evidence_updated.pdf",
"url": "http://ds.k8s.prozorro.local/get/8888888844445555666600000000000c?Signature=5fP2QhnDGx4g94Eu5t4DWAlWYGYecWbJeBhnz2XE3wFnuBnjILl6s%2FFjA7ON%2F5ga0lVujuTc9vv1d0%2BnzE%2FJCA%3D%3D&KeyID=a8968c46",
"hash": "md5:11111111111111111111111111111111",
"format": "application/pdf",
"documentType": "violationReportEvidence"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000000d
Content-Length: 502
{
"data": {
"id": "8888888844445555666600000000000b",
"hash": "md5:11111111111111111111111111111111",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/8888888844445555666600000000000e?download=8888888844445555666600000000000c",
"dateModified": "2025-10-12T15:37:10+03:00",
"datePublished": "2025-10-12T15:37:10+03:00",
"documentType": "violationReportEvidence",
"title": "evidence_updated.pdf",
"format": "application/pdf",
"language": "uk"
}
}
Update document details can be changed using PATCH method
Request
PATCH /violation_reports/UA-2025-10-12-000001/details/documents/8888888844445555666600000000000b HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "доказ_оновлений.pdf",
"title_en": "evidence_updated.pdf",
"description": "Висновок експерта, щодо пошкодженої деревини.",
"description_en": "Expert opinion regarding damaged wood."
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000000f
Content-Length: 926
{
"data": {
"id": "8888888844445555666600000000000b",
"hash": "md5:11111111111111111111111111111111",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/8888888844445555666600000000000e?download=8888888844445555666600000000000c",
"dateModified": "2025-10-12T15:37:45+03:00",
"datePublished": "2025-10-12T15:37:10+03:00",
"documentType": "violationReportEvidence",
"title": "доказ_оновлений.pdf",
"title_en": "evidence_updated.pdf",
"description": "Висновок експерта, щодо пошкодженої деревини.",
"description_en": "Expert opinion regarding damaged wood.",
"format": "application/pdf",
"language": "uk"
}
}
Before publishing, it’s required to add a signature document
Request
POST /violation_reports/UA-2025-10-12-000001/details/documents HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "sign.p7s",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000010?Signature=pzXOh33YS5Yhqt4K8SKsKeV6%2Bad4EYaE5s1Hr8LQiDwZfQVQuf9wue4bPgb1rFNKLcititQMVRNF7UPBzVyYAg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature",
"documentType": "violationReportSignature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000011
Content-Length: 503
{
"data": {
"id": "88888888444455556666000000000012",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/88888888444455556666000000000012?download=88888888444455556666000000000010",
"dateModified": "2025-10-12T15:38:47+03:00",
"datePublished": "2025-10-12T15:38:47+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
}
Now you can publish your violation report by changing its status
Request
PATCH /violation_reports/UA-2025-10-12-000001 HTTP/1.0
Authorization: Bearer broker
{
"data": {
"status": "pending"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000013
Content-Length: 3302
{
"data": {
"details": {
"reason": "goodsNonCompliance",
"description": "Якість товару не відповідає нормі.",
"documents": [
{
"id": "8888888844445555666600000000000b",
"hash": "md5:11111111111111111111111111111111",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/8888888844445555666600000000000e?download=8888888844445555666600000000000c",
"dateModified": "2025-10-12T15:37:45+03:00",
"datePublished": "2025-10-12T15:37:10+03:00",
"documentType": "violationReportEvidence",
"title": "доказ_оновлений.pdf",
"title_en": "evidence_updated.pdf",
"description": "Висновок експерта, щодо пошкодженої деревини.",
"description_en": "Expert opinion regarding damaged wood.",
"format": "application/pdf",
"language": "uk"
},
{
"id": "88888888444455556666000000000012",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/88888888444455556666000000000012?download=88888888444455556666000000000010",
"dateModified": "2025-10-12T15:38:47+03:00",
"datePublished": "2025-10-12T15:38:47+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
],
"dateModified": "2025-10-12T15:38:47+03:00"
},
"id": "UA-2025-10-12-000001",
"status": "pending",
"tender_id": "88888888444455556666000000000002",
"contract_id": "88888888444455556666000000000001",
"dateCreated": "2025-10-12T15:35:35+03:00",
"dateModified": "2025-10-12T15:39:22+03:00",
"datePublished": "2025-10-12T15:39:22+03:00",
"author": {
"name": "Adam Bryan",
"identifier": {
"id": "534962516",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "298 Michael Street Apt. 869",
"postalCode": "66552",
"countryName": "Chad"
},
"contactPoint": {
"name": "Nathan Lee",
"email": "marc75@example.org",
"telephone": "560.702.9241x61926",
"faxNumber": "8314738249",
"url": "http://www.lucero-collier.com/"
},
"kind": "general"
},
"defendants": [
{
"name": "Hannah Peterson",
"identifier": {
"id": "500071620",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "81790 Connie Islands Suite 835",
"postalCode": "87381",
"countryName": "Qatar"
},
"contactPoint": {
"name": "Chase Simpson",
"email": "jerry22@example.com",
"telephone": "(381)680-2072",
"faxNumber": "461.576.2320x55262",
"url": "https://wilson-schneider.com/"
},
"scale": "large"
}
],
"authority": {
"name": "Chad Shannon",
"identifier": {
"id": "942880460",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "891 Eric Station Apt. 475",
"postalCode": "53164",
"countryName": "Gambia"
},
"contactPoint": {
"name": "Dennis Mclaughlin",
"email": "cwilliams@example.org",
"telephone": "852.901.0193",
"faxNumber": "(645)734-5619",
"url": "http://martin.com/"
},
"kind": "central"
},
"defendantPeriod": {
"startDate": "2025-10-12T15:39:22+03:00",
"endDate": "2025-10-16T00:00:00+03:00"
}
}
}
See defendantPeriod that restrict the periods of the response can be posted. The decision can be posted once the period ends.
Post the defendant statement
Post a draft dependant statement
Request
POST /violation_reports/UA-2025-10-12-000001/defendantStatements HTTP/1.0
Authorization: Bearer broker
{
"data": {
"description": "В усьому винні бобри.",
"documents": [
{
"title": "beavers.gif",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000014?Signature=ZIIrhZX1BgFMM9cY7ThgYvVJlbVGQ7gajeZW6I1NRsfH%2B%2BCmg2rrjYrqG%2FK2Gp0p7pKsGEgiK5U0%2FX6up%2F7BBg%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "image/gif",
"documentType": "violationReportEvidence"
}
]
}
}
Response
HTTP/1.0 201 Created
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000015
Content-Length: 780
{
"data": {
"id": "88888888444455556666000000000016",
"description": "В усьому винні бобри.",
"documents": [
{
"id": "88888888444455556666000000000017",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/88888888444455556666000000000017?download=88888888444455556666000000000014",
"dateModified": "2025-10-13T01:54:34+03:00",
"datePublished": "2025-10-13T01:54:34+03:00",
"documentType": "violationReportEvidence",
"title": "beavers.gif",
"format": "image/gif",
"language": "uk"
}
],
"dateModified": "2025-10-13T01:54:34+03:00",
"status": "draft"
}
}
While is not active, you can update it
Request
PATCH /violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016 HTTP/1.0
Authorization: Bearer broker
{
"data": {
"description": "В усьому винні бобри. Обіцяли, що більше не будуть."
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000018
Content-Length: 925
{
"data": {
"id": "88888888444455556666000000000016",
"description": "В усьому винні бобри. Обіцяли, що більше не будуть.",
"documents": [
{
"id": "88888888444455556666000000000017",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/88888888444455556666000000000017?download=88888888444455556666000000000014",
"dateModified": "2025-10-13T01:54:34+03:00",
"datePublished": "2025-10-13T01:54:34+03:00",
"documentType": "violationReportEvidence",
"title": "beavers.gif",
"format": "image/gif",
"language": "uk"
}
],
"dateModified": "2025-10-13T01:54:49+03:00",
"status": "draft"
}
}
You can delete a document
Request
DELETE /violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/88888888444455556666000000000017 HTTP/1.0
Authorization: Bearer broker
Response
HTTP/1.0 204 No Content
X-Request-ID: 88888888-4444-5555-6666-000000000019
Then post a new one
Request
POST /violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "defendant_statement_2.pdf",
"url": "http://ds.k8s.prozorro.local/get/8888888844445555666600000000001a?Signature=6zJB4F1Eq8PFG0MHhnoe938ww31G%2BStm7QfLuyLlLdR9Irxus0ZsJoT7bFDDAgqRUy0WtLyAo7m%2Bc%2F4ynH3yBQ%3D%3D&KeyID=a8968c46",
"hash": "md5:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"format": "application/pdf",
"documentType": "violationReportEvidence"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000001b
Content-Length: 552
{
"data": {
"id": "8888888844445555666600000000001c",
"hash": "md5:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/8888888844445555666600000000001c?download=8888888844445555666600000000001a",
"dateModified": "2025-10-13T01:55:19+03:00",
"datePublished": "2025-10-13T01:55:19+03:00",
"documentType": "violationReportEvidence",
"title": "defendant_statement_2.pdf",
"format": "application/pdf",
"language": "uk"
}
}
And update the evidences
Request
PUT /violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/8888888844445555666600000000001c HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "ai_generated_beavers_0001.gif",
"url": "http://ds.k8s.prozorro.local/get/8888888844445555666600000000001d?Signature=KSrlQAiXGxV%2B6OCfzAAxT9jxSLFAIV5ZRvgnh5LUca26FXNh8Eij%2B1hc6Y9n5vXnQHatGCLfiLy2YxQVfvvuAw%3D%3D&KeyID=a8968c46",
"hash": "md5:22222222222222222222222222222222",
"format": "image/gif",
"documentType": "violationReportEvidence"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000001e
Content-Length: 550
{
"data": {
"id": "8888888844445555666600000000001c",
"hash": "md5:22222222222222222222222222222222",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/8888888844445555666600000000001f?download=8888888844445555666600000000001d",
"dateModified": "2025-10-13T01:55:34+03:00",
"datePublished": "2025-10-13T01:55:34+03:00",
"documentType": "violationReportEvidence",
"title": "ai_generated_beavers_0001.gif",
"format": "image/gif",
"language": "uk"
}
}
Change documents descriptions
Request
PATCH /violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/8888888844445555666600000000001c HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "доказ_оновлений.pdf",
"description": "Докази причетності бобрів.",
"description_en": "Evidence of beaver involvement."
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000020
Content-Length: 823
{
"data": {
"id": "8888888844445555666600000000001c",
"hash": "md5:22222222222222222222222222222222",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/8888888844445555666600000000001f?download=8888888844445555666600000000001d",
"dateModified": "2025-10-13T01:56:09+03:00",
"datePublished": "2025-10-13T01:55:34+03:00",
"documentType": "violationReportEvidence",
"title": "доказ_оновлений.pdf",
"description": "Докази причетності бобрів.",
"description_en": "Evidence of beaver involvement.",
"format": "image/gif",
"language": "uk"
}
}
Before publishing it’s required to add a signature document
Request
POST /violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "sign.p7s",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000021?Signature=aBAmD0RXTXJTCOImqgld4ytJc7dUbIDlWekXbeAOLrUTu54Eskaiplw7u2Jm4euROoTWpxV7OWZU3rLaeV7PBw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature",
"documentType": "violationReportSignature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000022
Content-Length: 548
{
"data": {
"id": "88888888444455556666000000000023",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/88888888444455556666000000000023?download=88888888444455556666000000000021",
"dateModified": "2025-10-13T01:56:24+03:00",
"datePublished": "2025-10-13T01:56:24+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
}
Then publish the statement, so it appears in the feed
Request
PATCH /violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016 HTTP/1.0
Authorization: Bearer broker
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000024
Content-Length: 1803
{
"data": {
"id": "88888888444455556666000000000016",
"description": "В усьому винні бобри. Обіцяли, що більше не будуть.",
"documents": [
{
"id": "8888888844445555666600000000001c",
"hash": "md5:22222222222222222222222222222222",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/8888888844445555666600000000001f?download=8888888844445555666600000000001d",
"dateModified": "2025-10-13T01:56:09+03:00",
"datePublished": "2025-10-13T01:55:34+03:00",
"documentType": "violationReportEvidence",
"title": "доказ_оновлений.pdf",
"description": "Докази причетності бобрів.",
"description_en": "Evidence of beaver involvement.",
"format": "image/gif",
"language": "uk"
},
{
"id": "88888888444455556666000000000023",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/88888888444455556666000000000023?download=88888888444455556666000000000021",
"dateModified": "2025-10-13T01:56:24+03:00",
"datePublished": "2025-10-13T01:56:24+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
],
"dateModified": "2025-10-13T01:56:24+03:00",
"datePublished": "2025-10-13T01:56:39+03:00",
"status": "active"
}
}
Post the decision
Create a draft decision
Request
POST /violation_reports/UA-2025-10-12-000001/decisions HTTP/1.0
Authorization: Bearer broker
{
"data": {
"resolution": "satisfied",
"description": "Суворо засуджуємо бобрів.",
"documents": [
{
"title": "protocol.pdf",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000025?Signature=6JxrJ%2BwNKsRCI2xDBiiL%2F8pj15XhjYYFV2eTptnZcCfCIxkK7leYwPpIgSAYwse32fo1OdfHvB1acss2wjuiCQ%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pdf",
"documentType": "violationReportEvidence"
}
]
}
}
Response
HTTP/1.0 201 Created
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000026
Content-Length: 833
{
"data": {
"id": "88888888444455556666000000000027",
"resolution": "satisfied",
"description": "Суворо засуджуємо бобрів.",
"documents": [
{
"id": "88888888444455556666000000000028",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000028?download=88888888444455556666000000000025",
"dateModified": "2025-10-16T10:15:00+03:00",
"datePublished": "2025-10-16T10:15:00+03:00",
"documentType": "violationReportEvidence",
"title": "protocol.pdf",
"format": "application/pdf",
"language": "uk"
}
],
"dateModified": "2025-10-16T10:15:00+03:00",
"status": "draft"
}
}
It’s required to add a signature document
Request
POST /violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "sign.p7s",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000029?Signature=ZN4h0KeEBT7dp7aIfFrjBP%2FvkzCZhg3fdg0KtoPGN5Y9NcXGCPVilJXNoKJu7GVl3cz3YmbiUkiV91XTtJ1RCw%3D%3D&KeyID=a8968c46",
"hash": "md5:00000000000000000000000000000000",
"format": "application/pkcs7-signature",
"documentType": "violationReportSignature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000002a
Content-Length: 538
{
"data": {
"id": "8888888844445555666600000000002b",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/8888888844445555666600000000002b?download=88888888444455556666000000000029",
"dateModified": "2025-10-16T10:15:12+03:00",
"datePublished": "2025-10-16T10:15:12+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
}
While in draft, you can change the decision
Request
PATCH /violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027 HTTP/1.0
Authorization: Bearer broker
{
"data": {
"resolution": "declinedNoViolation",
"description": "Комісія дійшла висновку, що ці бобри не підпадають під гриф \"таємно\" або \"для службового користування\"."
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000002c
Content-Length: 1760
{
"data": {
"id": "88888888444455556666000000000027",
"resolution": "declinedNoViolation",
"description": "Комісія дійшла висновку, що ці бобри не підпадають під гриф \"таємно\" або \"для службового користування\".",
"documents": [
{
"id": "88888888444455556666000000000028",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000028?download=88888888444455556666000000000025",
"dateModified": "2025-10-16T10:15:00+03:00",
"datePublished": "2025-10-16T10:15:00+03:00",
"documentType": "violationReportEvidence",
"title": "protocol.pdf",
"format": "application/pdf",
"language": "uk"
},
{
"id": "8888888844445555666600000000002b",
"hash": "md5:00000000000000000000000000000000",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/8888888844445555666600000000002b?download=88888888444455556666000000000029",
"dateModified": "2025-10-16T10:15:12+03:00",
"datePublished": "2025-10-16T10:15:12+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
],
"dateModified": "2025-10-16T10:15:24+03:00",
"status": "draft"
}
}
You can delete a document
Request
DELETE /violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000028 HTTP/1.0
Authorization: Bearer broker
Response
HTTP/1.0 204 No Content
X-Request-ID: 88888888-4444-5555-6666-00000000002d
Then post a new one
Request
POST /violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "protocol(2).pdf",
"url": "http://ds.k8s.prozorro.local/get/8888888844445555666600000000002e?Signature=yL50lAlm7w0hOo0u2wycJrc68JwK9Ax9LEPxsmM4bveZ9CX1ybdZUk%2BLsb3mQDkog%2FQcknRxXCsU9C2cqBO8CQ%3D%3D&KeyID=a8968c46",
"hash": "md5:ffffffffffffffffffffffffffffffff",
"format": "application/pdf",
"documentType": "violationReportEvidence"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-00000000002f
Content-Length: 532
{
"data": {
"id": "88888888444455556666000000000030",
"hash": "md5:ffffffffffffffffffffffffffffffff",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000030?download=8888888844445555666600000000002e",
"dateModified": "2025-10-16T10:15:54+03:00",
"datePublished": "2025-10-16T10:15:54+03:00",
"documentType": "violationReportEvidence",
"title": "protocol(2).pdf",
"format": "application/pdf",
"language": "uk"
}
}
Before publishing, you need to update the signature
Request
PUT /violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/8888888844445555666600000000002b HTTP/1.0
Authorization: Bearer broker
{
"data": {
"title": "sign_1.p7s",
"url": "http://ds.k8s.prozorro.local/get/88888888444455556666000000000031?Signature=Nqx4GVun7sIeambweuLHtn6U1t3O7rx5nFKWK3W8Pt9J9dDgLk5LpbRRaMtbPHotW9OcJ4ZMTzVNYHI9PD5CAw%3D%3D&KeyID=a8968c46",
"hash": "md5:33333333333333333333333333333333",
"format": "application/pkcs7-signature",
"documentType": "violationReportSignature"
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000032
Content-Length: 540
{
"data": {
"id": "8888888844445555666600000000002b",
"hash": "md5:33333333333333333333333333333333",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000033?download=88888888444455556666000000000031",
"dateModified": "2025-10-16T10:16:06+03:00",
"datePublished": "2025-10-16T10:16:06+03:00",
"documentType": "violationReportSignature",
"title": "sign_1.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
}
Publish the decision
Request
PATCH /violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027 HTTP/1.0
Authorization: Bearer broker
{
"data": {
"status": "active"
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000034
Content-Length: 1812
{
"data": {
"id": "88888888444455556666000000000027",
"resolution": "declinedNoViolation",
"description": "Комісія дійшла висновку, що ці бобри не підпадають під гриф \"таємно\" або \"для службового користування\".",
"documents": [
{
"id": "88888888444455556666000000000030",
"hash": "md5:ffffffffffffffffffffffffffffffff",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000030?download=8888888844445555666600000000002e",
"dateModified": "2025-10-16T10:15:54+03:00",
"datePublished": "2025-10-16T10:15:54+03:00",
"documentType": "violationReportEvidence",
"title": "protocol(2).pdf",
"format": "application/pdf",
"language": "uk"
},
{
"id": "8888888844445555666600000000002b",
"hash": "md5:33333333333333333333333333333333",
"url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000033?download=88888888444455556666000000000031",
"dateModified": "2025-10-16T10:16:06+03:00",
"datePublished": "2025-10-16T10:16:06+03:00",
"documentType": "violationReportSignature",
"title": "sign_1.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
],
"dateModified": "2025-10-16T10:16:06+03:00",
"datePublished": "2025-10-16T10:16:08+03:00",
"status": "active"
}
}
See the result violation report object
Request
GET /violation_reports/UA-2025-10-12-000001 HTTP/1.0
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000035
Content-Length: 6977
{
"data": {
"details": {
"reason": "goodsNonCompliance",
"description": "Якість товару не відповідає нормі.",
"documents": [
{
"id": "8888888844445555666600000000000b",
"hash": "md5:11111111111111111111111111111111",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/8888888844445555666600000000000e?download=8888888844445555666600000000000c",
"dateModified": "2025-10-12T15:37:45+03:00",
"datePublished": "2025-10-12T15:37:10+03:00",
"documentType": "violationReportEvidence",
"title": "доказ_оновлений.pdf",
"title_en": "evidence_updated.pdf",
"description": "Висновок експерта, щодо пошкодженої деревини.",
"description_en": "Expert opinion regarding damaged wood.",
"format": "application/pdf",
"language": "uk"
},
{
"id": "88888888444455556666000000000012",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/details/documents/88888888444455556666000000000012?download=88888888444455556666000000000010",
"dateModified": "2025-10-12T15:38:47+03:00",
"datePublished": "2025-10-12T15:38:47+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
],
"dateModified": "2025-10-12T15:38:47+03:00"
},
"id": "UA-2025-10-12-000001",
"status": "declinedNoViolation",
"tender_id": "88888888444455556666000000000002",
"contract_id": "88888888444455556666000000000001",
"dateCreated": "2025-10-12T15:35:35+03:00",
"dateModified": "2025-10-16T10:16:08+03:00",
"datePublished": "2025-10-12T15:39:22+03:00",
"author": {
"name": "Adam Bryan",
"identifier": {
"id": "534962516",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "298 Michael Street Apt. 869",
"postalCode": "66552",
"countryName": "Chad"
},
"contactPoint": {
"name": "Nathan Lee",
"email": "marc75@example.org",
"telephone": "560.702.9241x61926",
"faxNumber": "8314738249",
"url": "http://www.lucero-collier.com/"
},
"kind": "general"
},
"defendants": [
{
"name": "Hannah Peterson",
"identifier": {
"id": "500071620",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "81790 Connie Islands Suite 835",
"postalCode": "87381",
"countryName": "Qatar"
},
"contactPoint": {
"name": "Chase Simpson",
"email": "jerry22@example.com",
"telephone": "(381)680-2072",
"faxNumber": "461.576.2320x55262",
"url": "https://wilson-schneider.com/"
},
"scale": "large"
}
],
"authority": {
"name": "Chad Shannon",
"identifier": {
"id": "942880460",
"scheme": "UA-EDR"
},
"address": {
"streetAddress": "891 Eric Station Apt. 475",
"postalCode": "53164",
"countryName": "Gambia"
},
"contactPoint": {
"name": "Dennis Mclaughlin",
"email": "cwilliams@example.org",
"telephone": "852.901.0193",
"faxNumber": "(645)734-5619",
"url": "http://martin.com/"
},
"kind": "central"
},
"defendantPeriod": {
"startDate": "2025-10-12T15:39:22+03:00",
"endDate": "2025-10-16T00:00:00+03:00"
},
"defendantStatements": [
{
"id": "88888888444455556666000000000016",
"description": "В усьому винні бобри. Обіцяли, що більше не будуть.",
"documents": [
{
"id": "8888888844445555666600000000001c",
"hash": "md5:22222222222222222222222222222222",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/8888888844445555666600000000001f?download=8888888844445555666600000000001d",
"dateModified": "2025-10-13T01:56:09+03:00",
"datePublished": "2025-10-13T01:55:34+03:00",
"documentType": "violationReportEvidence",
"title": "доказ_оновлений.pdf",
"description": "Докази причетності бобрів.",
"description_en": "Evidence of beaver involvement.",
"format": "image/gif",
"language": "uk"
},
{
"id": "88888888444455556666000000000023",
"hash": "md5:00000000000000000000000000000000",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/defendantStatements/88888888444455556666000000000016/documents/88888888444455556666000000000023?download=88888888444455556666000000000021",
"dateModified": "2025-10-13T01:56:24+03:00",
"datePublished": "2025-10-13T01:56:24+03:00",
"documentType": "violationReportSignature",
"title": "sign.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
],
"dateModified": "2025-10-13T01:56:24+03:00",
"datePublished": "2025-10-13T01:56:39+03:00",
"status": "active"
}
],
"decisions": [
{
"id": "88888888444455556666000000000027",
"resolution": "declinedNoViolation",
"description": "Комісія дійшла висновку, що ці бобри не підпадають під гриф \"таємно\" або \"для службового користування\".",
"documents": [
{
"id": "88888888444455556666000000000030",
"hash": "md5:ffffffffffffffffffffffffffffffff",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000030?download=8888888844445555666600000000002e",
"dateModified": "2025-10-16T10:15:54+03:00",
"datePublished": "2025-10-16T10:15:54+03:00",
"documentType": "violationReportEvidence",
"title": "protocol(2).pdf",
"format": "application/pdf",
"language": "uk"
},
{
"id": "8888888844445555666600000000002b",
"hash": "md5:33333333333333333333333333333333",
"url": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/violation_reports/UA-2025-10-12-000001/decisions/88888888444455556666000000000027/documents/88888888444455556666000000000033?download=88888888444455556666000000000031",
"dateModified": "2025-10-16T10:16:06+03:00",
"datePublished": "2025-10-16T10:16:06+03:00",
"documentType": "violationReportSignature",
"title": "sign_1.p7s",
"format": "application/pkcs7-signature",
"language": "uk"
}
],
"dateModified": "2025-10-16T10:16:06+03:00",
"datePublished": "2025-10-16T10:16:08+03:00",
"status": "active"
}
]
}
}
Field status of violation report depends on the decision status now.
Feed violation report updates
Violation reports appear in their feed when the get public changes.
- These are:
violationReport is published
defendantStatement is published
decision is published
Request
GET /violation_reports HTTP/1.0
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000036
Content-Length: 379
{
"data": [
{
"dateModified": "2025-10-16T10:16:08+03:00",
"id": "UA-2025-10-12-000001"
}
],
"next_page": {
"offset": "1763200489.262.1.bf2af5c632c705c7ce7e7c4948e62efa",
"path": "/violation_reports?offset=1763200489.262.1.bf2af5c632c705c7ce7e7c4948e62efa",
"uri": "http://public-api-sandbox.prozorro.gov.ua/violation_reports?offset=1763200489.262.1.bf2af5c632c705c7ce7e7c4948e62efa"
}
}
Process objects in data and follow the next_page
Request
GET /violation_reports?offset=1763200489.262.1.bf2af5c632c705c7ce7e7c4948e62efa HTTP/1.0
Response
HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 88888888-4444-5555-6666-000000000037
Content-Length: 459
{
"data": [],
"next_page": {
"offset": "1763200489.262.1.bf2af5c632c705c7ce7e7c4948e62efa",
"path": "/violation_reports?offset=1763200489.262.1.bf2af5c632c705c7ce7e7c4948e62efa",
"uri": "http://public-api-sandbox.prozorro.gov.ua/violation_reports?offset=1763200489.262.1.bf2af5c632c705c7ce7e7c4948e62efa"
},
"prev_page": {
"offset": "",
"path": "/violation_reports?descending=1",
"uri": "http://public-api-sandbox.prozorro.gov.ua/violation_reports?descending=1"
}
}
Once data is empty make your script sleep for a while and check the same page later.