Туторіал

Базові правила

Подивимось як працює точка входу /agreements:

Request

GET /api/2.5/agreements HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": [],
  "next_page": {
    "offset": "",
    "path": "/api/2.5/agreements",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements"
  }
}

При виклику видає пустий набір.

Угода автоматично переноситься з модуля тендера.

Створення реєстру

Припустимо, що є кваліфікація, заявка та рішення по заявці в статусах active. Коли заявка в стаусі active і ви оновлюєте рішення по заявці до active статусу система автоматично створює реєстр(з кваліфікації) з контрактом(з рішення по заявці).

Отримання реєстру

Перевіримо нашу кваліфікацію:

Request

GET /api/2.5/frameworks/5028030e17804dd8b73bdd9dd287a845 HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "prettyID": "UA-F-2023-01-01-000001",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "status": "active",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "owner": "test",
    "date": "2023-01-01T00:00:00+02:00",
    "dateCreated": "2023-01-01T00:00:00+02:00",
    "dateModified": "2023-01-16T00:00:00+02:00",
    "period": {
      "startDate": "2022-12-31T23:00:00+02:00",
      "endDate": "2023-04-01T00:00:00+03:00"
    },
    "qualificationPeriod": {
      "startDate": "2022-12-31T23:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2022-12-31T23:00:00+02:00",
      "endDate": "2023-01-14T00:00:00+02:00",
      "clarificationsUntil": "2023-01-19T00:00:00+02:00"
    },
    "next_check": "2023-01-28T00:00:00+02:00",
    "frameworkType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "agreementID": "5802d80bdd4e4c9bbd5495240c9ebe6e",
    "id": "5028030e17804dd8b73bdd9dd287a845"
  },
  "config": {}
}

В нашій кваліфікації ви можете знайти поле agreementID в якому зберегіється ідентифікатор пов’язоного реєстру. Тепер ми можемо отримати на реєстр:

Request

GET /api/2.5/agreements/5802d80bdd4e4c9bbd5495240c9ebe6e HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "agreementID": "UA-2023-01-16-000001",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "contracts": [
      {
        "id": "0ab687a72fe04fc082a29a8ae9790d75",
        "qualificationID": "8bad28a67429465881d215ec46093663",
        "status": "active",
        "submissionID": "b28adb58e24e453c96e7d4aab646766f",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "b8bc7b1976f74faba4ae1a8d5133c035",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "1526b7f28193460bad051058fbd9f6d4",
        "qualificationID": "fbc3f04b829448c89a90698ddbbe759e",
        "status": "active",
        "submissionID": "16ab206568e04c8fb42799f8d698cf0a",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "a1b2b3087ce1452ba7e6eceea4f8ed7c",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "dateModified": "2023-01-16T00:00:00+02:00",
    "date": "2023-01-16T00:00:00+02:00",
    "owner": "test",
    "agreementType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "frameworkID": "5028030e17804dd8b73bdd9dd287a845",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "next_check": "2023-05-01T00:00:00+02:00",
    "id": "5802d80bdd4e4c9bbd5495240c9ebe6e"
  },
  "config": {}
}

Зміна реєстру

Всі операцї над реєстром може виконувати лише framework_owner. Лише одна річ, яку може робити framework_owner це додавати/змінювати майлстони до контракту.

Контракт - об’єкт що зберігає інформацію про учасника.

Майлстон - це історія контраку.

Бан контракту

For ban contract, you just need to add milestone to contract with type ban:

Request

POST /api/2.5/agreements/5802d80bdd4e4c9bbd5495240c9ebe6e/contracts/0ab687a72fe04fc082a29a8ae9790d75/milestones?acc_token=9a38d9ba334f4452a12d1a9c94643df0 HTTP/1.0
Authorization: Bearer token
Content-Length: 491
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "type": "ban",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "milestone.doc",
        "format": "application/msword",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "id": "cd52b90af77e4f5b8cb0f210e83987b5",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5ce8807b1c3340f39913e264387d8f38?Signature=FlXL02QnwffTbXUFIKSRvBgcZlgC9OsL058U%2FNaTy2TtsfjzhFxHPZV6ehKfidM1XcLdcI35gPMCrL4cNlN5Bw%3D%3D&KeyID=a8968c46"
      }
    ]
  }
}

Response

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

{
  "data": {
    "type": "ban",
    "documents": [
      {
        "id": "cd52b90af77e4f5b8cb0f210e83987b5",
        "datePublished": "2020-09-08T01:00:00+03:00",
        "hash": "md5:00000000000000000000000000000000",
        "title": "milestone.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5ce8807b1c3340f39913e264387d8f38?Signature=h3Xve9Q40jQWKAczqvya8%2F1QKyovh%2BCCuhd2EU5WKt0Z%2FreOLgIX%2B1ErKONH%2FdxtPueIkcw3d9JJN%2BfCJUG4Cw%3D%3D&KeyID=a8968c46",
        "dateModified": "2020-09-08T01:00:00+03:00",
        "language": "uk"
      }
    ],
    "status": "scheduled",
    "id": "31ba3bc7f2204f73a52ada17a04196c8",
    "dueDate": "2023-04-16T00:00:00+02:00",
    "dateModified": "2023-01-16T00:00:00+02:00"
  }
}

You can see that contract status was automatically changed to suspended:

Request

GET /api/2.5/agreements/5802d80bdd4e4c9bbd5495240c9ebe6e HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "agreementID": "UA-2023-01-16-000001",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "contracts": [
      {
        "id": "0ab687a72fe04fc082a29a8ae9790d75",
        "qualificationID": "8bad28a67429465881d215ec46093663",
        "status": "suspended",
        "submissionID": "b28adb58e24e453c96e7d4aab646766f",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "b8bc7b1976f74faba4ae1a8d5133c035",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "id": "cd52b90af77e4f5b8cb0f210e83987b5",
                "datePublished": "2020-09-08T01:00:00+03:00",
                "hash": "md5:00000000000000000000000000000000",
                "title": "milestone.doc",
                "format": "application/msword",
                "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5ce8807b1c3340f39913e264387d8f38?Signature=h3Xve9Q40jQWKAczqvya8%2F1QKyovh%2BCCuhd2EU5WKt0Z%2FreOLgIX%2B1ErKONH%2FdxtPueIkcw3d9JJN%2BfCJUG4Cw%3D%3D&KeyID=a8968c46",
                "dateModified": "2020-09-08T01:00:00+03:00",
                "language": "uk"
              }
            ],
            "status": "scheduled",
            "id": "31ba3bc7f2204f73a52ada17a04196c8",
            "dueDate": "2023-04-16T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "1526b7f28193460bad051058fbd9f6d4",
        "qualificationID": "fbc3f04b829448c89a90698ddbbe759e",
        "status": "active",
        "submissionID": "16ab206568e04c8fb42799f8d698cf0a",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "a1b2b3087ce1452ba7e6eceea4f8ed7c",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "dateModified": "2023-01-16T00:00:00+02:00",
    "date": "2023-01-16T00:00:00+02:00",
    "owner": "test",
    "agreementType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "frameworkID": "5028030e17804dd8b73bdd9dd287a845",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "next_check": "2023-04-16T00:00:00+02:00",
    "id": "5802d80bdd4e4c9bbd5495240c9ebe6e"
  },
  "config": {}
}

After dueDate date of milestone, contract will be automatically set back to active status.

Request

GET /api/2.5/agreements/5802d80bdd4e4c9bbd5495240c9ebe6e HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "agreementID": "UA-2023-01-16-000001",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "contracts": [
      {
        "id": "0ab687a72fe04fc082a29a8ae9790d75",
        "qualificationID": "8bad28a67429465881d215ec46093663",
        "status": "active",
        "submissionID": "b28adb58e24e453c96e7d4aab646766f",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "b8bc7b1976f74faba4ae1a8d5133c035",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "id": "cd52b90af77e4f5b8cb0f210e83987b5",
                "datePublished": "2020-09-08T01:00:00+03:00",
                "hash": "md5:00000000000000000000000000000000",
                "title": "milestone.doc",
                "format": "application/msword",
                "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5ce8807b1c3340f39913e264387d8f38?Signature=h3Xve9Q40jQWKAczqvya8%2F1QKyovh%2BCCuhd2EU5WKt0Z%2FreOLgIX%2B1ErKONH%2FdxtPueIkcw3d9JJN%2BfCJUG4Cw%3D%3D&KeyID=a8968c46",
                "dateModified": "2020-09-08T01:00:00+03:00",
                "language": "uk"
              }
            ],
            "status": "met",
            "id": "31ba3bc7f2204f73a52ada17a04196c8",
            "dueDate": "2023-04-16T00:00:00+02:00",
            "dateModified": "2023-04-16T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "1526b7f28193460bad051058fbd9f6d4",
        "qualificationID": "fbc3f04b829448c89a90698ddbbe759e",
        "status": "active",
        "submissionID": "16ab206568e04c8fb42799f8d698cf0a",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "a1b2b3087ce1452ba7e6eceea4f8ed7c",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "dateModified": "2023-04-16T01:00:00+03:00",
    "date": "2023-01-16T00:00:00+02:00",
    "owner": "test",
    "agreementType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "frameworkID": "5028030e17804dd8b73bdd9dd287a845",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "next_check": "2023-05-01T00:00:00+02:00",
    "id": "5802d80bdd4e4c9bbd5495240c9ebe6e"
  },
  "config": {}
}

Contract disqualify

You can see that contract was automatically created with activation milestone.

Field dueDate was automatically set with period.endDate date. On that date milestone will be automatically set to met status, and contract will switched status to terminated.

When you want to manually disqualify contract, you need to manually set activation milestone status to met:

Request

PATCH /api/2.5/agreements/5802d80bdd4e4c9bbd5495240c9ebe6e/contracts/0ab687a72fe04fc082a29a8ae9790d75/milestones/b8bc7b1976f74faba4ae1a8d5133c035?acc_token=9a38d9ba334f4452a12d1a9c94643df0 HTTP/1.0
Authorization: Bearer token
Content-Length: 27
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "met"
  }
}

Response

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

{
  "data": {
    "id": "b8bc7b1976f74faba4ae1a8d5133c035",
    "type": "activation",
    "status": "met",
    "dueDate": "2023-05-01T00:00:00+02:00",
    "dateModified": "2023-01-16T00:00:00+02:00"
  }
}

Now you can see that contract status was changed to terminated:

Request

GET /api/2.5/agreements/5802d80bdd4e4c9bbd5495240c9ebe6e HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "agreementID": "UA-2023-01-16-000001",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "contracts": [
      {
        "id": "0ab687a72fe04fc082a29a8ae9790d75",
        "qualificationID": "8bad28a67429465881d215ec46093663",
        "status": "terminated",
        "submissionID": "b28adb58e24e453c96e7d4aab646766f",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "b8bc7b1976f74faba4ae1a8d5133c035",
            "type": "activation",
            "status": "met",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "id": "cd52b90af77e4f5b8cb0f210e83987b5",
                "datePublished": "2020-09-08T01:00:00+03:00",
                "hash": "md5:00000000000000000000000000000000",
                "title": "milestone.doc",
                "format": "application/msword",
                "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5ce8807b1c3340f39913e264387d8f38?Signature=h3Xve9Q40jQWKAczqvya8%2F1QKyovh%2BCCuhd2EU5WKt0Z%2FreOLgIX%2B1ErKONH%2FdxtPueIkcw3d9JJN%2BfCJUG4Cw%3D%3D&KeyID=a8968c46",
                "dateModified": "2020-09-08T01:00:00+03:00",
                "language": "uk"
              }
            ],
            "status": "met",
            "id": "31ba3bc7f2204f73a52ada17a04196c8",
            "dueDate": "2023-04-16T00:00:00+02:00",
            "dateModified": "2023-04-16T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "1526b7f28193460bad051058fbd9f6d4",
        "qualificationID": "fbc3f04b829448c89a90698ddbbe759e",
        "status": "active",
        "submissionID": "16ab206568e04c8fb42799f8d698cf0a",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "a1b2b3087ce1452ba7e6eceea4f8ed7c",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "dateModified": "2023-04-16T01:00:00+03:00",
    "date": "2023-01-16T00:00:00+02:00",
    "owner": "test",
    "agreementType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "frameworkID": "5028030e17804dd8b73bdd9dd287a845",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "next_check": "2023-05-01T00:00:00+02:00",
    "id": "5802d80bdd4e4c9bbd5495240c9ebe6e"
  },
  "config": {}
}

Finishing agreement

Lets wait for period.endDate date and see what will happen:

Request

GET /api/2.5/agreements/5802d80bdd4e4c9bbd5495240c9ebe6e HTTP/1.0
Authorization: Bearer token
Host: public-api-sandbox.prozorro.gov.ua

Response

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

{
  "data": {
    "agreementID": "UA-2023-01-16-000001",
    "status": "terminated",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "contracts": [
      {
        "id": "0ab687a72fe04fc082a29a8ae9790d75",
        "qualificationID": "8bad28a67429465881d215ec46093663",
        "status": "terminated",
        "submissionID": "b28adb58e24e453c96e7d4aab646766f",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "b8bc7b1976f74faba4ae1a8d5133c035",
            "type": "activation",
            "status": "met",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "id": "cd52b90af77e4f5b8cb0f210e83987b5",
                "datePublished": "2020-09-08T01:00:00+03:00",
                "hash": "md5:00000000000000000000000000000000",
                "title": "milestone.doc",
                "format": "application/msword",
                "url": "http://public-docs-sandbox.prozorro.gov.ua/get/5ce8807b1c3340f39913e264387d8f38?Signature=h3Xve9Q40jQWKAczqvya8%2F1QKyovh%2BCCuhd2EU5WKt0Z%2FreOLgIX%2B1ErKONH%2FdxtPueIkcw3d9JJN%2BfCJUG4Cw%3D%3D&KeyID=a8968c46",
                "dateModified": "2020-09-08T01:00:00+03:00",
                "language": "uk"
              }
            ],
            "status": "met",
            "id": "31ba3bc7f2204f73a52ada17a04196c8",
            "dueDate": "2023-04-16T00:00:00+02:00",
            "dateModified": "2023-04-16T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "1526b7f28193460bad051058fbd9f6d4",
        "qualificationID": "fbc3f04b829448c89a90698ddbbe759e",
        "status": "terminated",
        "submissionID": "16ab206568e04c8fb42799f8d698cf0a",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            }
          }
        ],
        "milestones": [
          {
            "id": "a1b2b3087ce1452ba7e6eceea4f8ed7c",
            "type": "activation",
            "status": "met",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-10-13T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "dateModified": "2023-10-13T01:00:00+03:00",
    "date": "2023-01-16T00:00:00+02:00",
    "owner": "test",
    "agreementType": "electronicCatalogue",
    "procuringEntity": {
      "name": "Повна назва юридичної організації.",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "40996564",
        "legalName": "Назва організації(ЦЗО)"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Назва організації(ЦЗО)",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "central"
    },
    "frameworkID": "5028030e17804dd8b73bdd9dd287a845",
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "id": "5802d80bdd4e4c9bbd5495240c9ebe6e"
  },
  "config": {}
}

You can see that activation milestone was automatically set to met status, contract status was changed to terminated and agreement status was changed to terminated.