Tutorial

Exploring basic rules

Let’s try exploring the /agreements endpoint:

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"
  }
}

Just invoking it reveals an empty set.

Agreement is transferred from the tender system by an automated process.

Creating agreement

Let’s say that we have conducted framework, submission and qualification and it has active status. When the framework is active and you change qualification status to active, system automatically created agreement(from framework) with contract(from qualification).

Getting agreement

Let’s see our created framework:

Request

GET /api/2.5/frameworks/bdc325ff871a4c518086e628e1dd113b 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",
    "qualificationPeriod": {
      "endDate": "2023-05-01T00:00:00+02:00",
      "startDate": "2022-12-31T23: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"
    },
    "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"
    },
    "period": {
      "startDate": "2022-12-31T23:00:00+02:00",
      "endDate": "2023-04-01T00:00:00+03:00"
    },
    "next_check": "2023-01-28T00:00:00+02:00",
    "agreementID": "6a527caaceb94ad398f77579768a6d67",
    "id": "bdc325ff871a4c518086e628e1dd113b"
  },
  "config": {
    "restrictedDerivatives": false
  }
}

In our framework you can see the agreementID field where stores id of related agreement. When we know id of our agreement we can get it:

Request

GET /api/2.5/agreements/6a527caaceb94ad398f77579768a6d67 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",
    "frameworkID": "bdc325ff871a4c518086e628e1dd113b",
    "agreementType": "electronicCatalogue",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "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"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "contracts": [
      {
        "id": "a2ac96f0669b459981b24978efb9c192",
        "qualificationID": "cea184071f4b4f95b854eede0a95f34f",
        "submissionID": "55914259c674436d9e80c86d5cc4fc19",
        "status": "active",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "428d21a6c91445ca8785a53103c07905",
            "status": "scheduled",
            "type": "activation",
            "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": "67143902200745ca9004a1b0a564b4aa",
        "qualificationID": "a71870dfe19945ff859377d40e58a660",
        "submissionID": "f0d1e4003bc84247a2ea1b972c8b2ea3",
        "status": "active",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "659cb532d2ad40f1afd8b160f6bf230b",
            "status": "scheduled",
            "type": "activation",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "owner": "test",
    "dateModified": "2023-01-16T00:00:00+02:00",
    "date": "2023-01-16T00:00:00+02:00",
    "next_check": "2023-05-01T00:00:00+02:00",
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "id": "6a527caaceb94ad398f77579768a6d67"
  },
  "config": {
    "restricted": false
  }
}

Modifying agreement

All operation with agreement can make framework_owner. Only one thing that can make framework_owner is create/modify contract milestones.

Contract - object that stores information about participant

Milestone - that’s contract history.

Contract ban

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

Request

POST /api/2.5/agreements/6a527caaceb94ad398f77579768a6d67/contracts/a2ac96f0669b459981b24978efb9c192/milestones?acc_token=47f9fd2d63d44d3d9a5effcecf16fb82 HTTP/1.0
Authorization: Bearer token
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "type": "ban",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "milestone.doc",
        "format": "application/msword",
        "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": [
      {
        "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",
        "language": "uk",
        "id": "0016c472fdc940e1ba2a702553f7a9cd",
        "datePublished": "2023-01-16T00:00:00+02:00",
        "dateModified": "2023-01-16T00:00:00+02:00"
      }
    ],
    "status": "scheduled",
    "id": "cd5d86d574eb4a8d918cbd31d4b3ec6c",
    "dueDate": "2023-04-16T00:00:00+03: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/6a527caaceb94ad398f77579768a6d67 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",
    "frameworkID": "bdc325ff871a4c518086e628e1dd113b",
    "agreementType": "electronicCatalogue",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "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"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "contracts": [
      {
        "id": "a2ac96f0669b459981b24978efb9c192",
        "qualificationID": "cea184071f4b4f95b854eede0a95f34f",
        "submissionID": "55914259c674436d9e80c86d5cc4fc19",
        "status": "suspended",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "428d21a6c91445ca8785a53103c07905",
            "status": "scheduled",
            "type": "activation",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "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",
                "language": "uk",
                "id": "0016c472fdc940e1ba2a702553f7a9cd",
                "datePublished": "2023-01-16T00:00:00+02:00",
                "dateModified": "2023-01-16T00:00:00+02:00"
              }
            ],
            "status": "scheduled",
            "id": "cd5d86d574eb4a8d918cbd31d4b3ec6c",
            "dueDate": "2023-04-16T00:00:00+03:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "67143902200745ca9004a1b0a564b4aa",
        "qualificationID": "a71870dfe19945ff859377d40e58a660",
        "submissionID": "f0d1e4003bc84247a2ea1b972c8b2ea3",
        "status": "active",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "659cb532d2ad40f1afd8b160f6bf230b",
            "status": "scheduled",
            "type": "activation",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "owner": "test",
    "dateModified": "2023-01-16T00:00:00+02:00",
    "date": "2023-01-16T00:00:00+02:00",
    "next_check": "2023-04-16T00:00:00+03:00",
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "id": "6a527caaceb94ad398f77579768a6d67"
  },
  "config": {
    "restricted": false
  }
}

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

Request

GET /api/2.5/agreements/6a527caaceb94ad398f77579768a6d67 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",
    "frameworkID": "bdc325ff871a4c518086e628e1dd113b",
    "agreementType": "electronicCatalogue",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "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"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "contracts": [
      {
        "id": "a2ac96f0669b459981b24978efb9c192",
        "qualificationID": "cea184071f4b4f95b854eede0a95f34f",
        "submissionID": "55914259c674436d9e80c86d5cc4fc19",
        "status": "active",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "428d21a6c91445ca8785a53103c07905",
            "status": "scheduled",
            "type": "activation",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "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",
                "language": "uk",
                "id": "0016c472fdc940e1ba2a702553f7a9cd",
                "datePublished": "2023-01-16T00:00:00+02:00",
                "dateModified": "2023-01-16T00:00:00+02:00"
              }
            ],
            "status": "met",
            "id": "cd5d86d574eb4a8d918cbd31d4b3ec6c",
            "dueDate": "2023-04-16T00:00:00+03:00",
            "dateModified": "2023-04-16T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "67143902200745ca9004a1b0a564b4aa",
        "qualificationID": "a71870dfe19945ff859377d40e58a660",
        "submissionID": "f0d1e4003bc84247a2ea1b972c8b2ea3",
        "status": "active",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "659cb532d2ad40f1afd8b160f6bf230b",
            "status": "scheduled",
            "type": "activation",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "owner": "test",
    "dateModified": "2023-04-16T01:00:00+03:00",
    "date": "2023-01-16T00:00:00+02:00",
    "next_check": "2023-05-01T00:00:00+02:00",
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "id": "6a527caaceb94ad398f77579768a6d67"
  },
  "config": {
    "restricted": false
  }
}

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/6a527caaceb94ad398f77579768a6d67/contracts/a2ac96f0669b459981b24978efb9c192/milestones/428d21a6c91445ca8785a53103c07905?acc_token=47f9fd2d63d44d3d9a5effcecf16fb82 HTTP/1.0
Authorization: Bearer token
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": "428d21a6c91445ca8785a53103c07905",
    "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/6a527caaceb94ad398f77579768a6d67 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",
    "frameworkID": "bdc325ff871a4c518086e628e1dd113b",
    "agreementType": "electronicCatalogue",
    "status": "active",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "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"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "contracts": [
      {
        "id": "a2ac96f0669b459981b24978efb9c192",
        "qualificationID": "cea184071f4b4f95b854eede0a95f34f",
        "submissionID": "55914259c674436d9e80c86d5cc4fc19",
        "status": "terminated",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "428d21a6c91445ca8785a53103c07905",
            "type": "activation",
            "status": "met",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "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",
                "language": "uk",
                "id": "0016c472fdc940e1ba2a702553f7a9cd",
                "datePublished": "2023-01-16T00:00:00+02:00",
                "dateModified": "2023-01-16T00:00:00+02:00"
              }
            ],
            "status": "met",
            "id": "cd5d86d574eb4a8d918cbd31d4b3ec6c",
            "dueDate": "2023-04-16T00:00:00+03:00",
            "dateModified": "2023-04-16T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "67143902200745ca9004a1b0a564b4aa",
        "qualificationID": "a71870dfe19945ff859377d40e58a660",
        "submissionID": "f0d1e4003bc84247a2ea1b972c8b2ea3",
        "status": "active",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "659cb532d2ad40f1afd8b160f6bf230b",
            "status": "scheduled",
            "type": "activation",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "owner": "test",
    "dateModified": "2023-04-16T01:00:00+03:00",
    "date": "2023-01-16T00:00:00+02:00",
    "next_check": "2023-05-01T00:00:00+02:00",
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "id": "6a527caaceb94ad398f77579768a6d67"
  },
  "config": {
    "restricted": false
  }
}

Finishing agreement

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

Request

GET /api/2.5/agreements/6a527caaceb94ad398f77579768a6d67 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",
    "frameworkID": "bdc325ff871a4c518086e628e1dd113b",
    "agreementType": "electronicCatalogue",
    "status": "terminated",
    "period": {
      "startDate": "2023-01-16T00:00:00+02:00",
      "endDate": "2023-05-01T00:00:00+02:00"
    },
    "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"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "contracts": [
      {
        "id": "a2ac96f0669b459981b24978efb9c192",
        "qualificationID": "cea184071f4b4f95b854eede0a95f34f",
        "submissionID": "55914259c674436d9e80c86d5cc4fc19",
        "status": "terminated",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "428d21a6c91445ca8785a53103c07905",
            "type": "activation",
            "status": "met",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-01-16T00:00:00+02:00"
          },
          {
            "type": "ban",
            "documents": [
              {
                "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",
                "language": "uk",
                "id": "0016c472fdc940e1ba2a702553f7a9cd",
                "datePublished": "2023-01-16T00:00:00+02:00",
                "dateModified": "2023-01-16T00:00:00+02:00"
              }
            ],
            "status": "met",
            "id": "cd5d86d574eb4a8d918cbd31d4b3ec6c",
            "dueDate": "2023-04-16T00:00:00+03:00",
            "dateModified": "2023-04-16T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      },
      {
        "id": "67143902200745ca9004a1b0a564b4aa",
        "qualificationID": "a71870dfe19945ff859377d40e58a660",
        "submissionID": "f0d1e4003bc84247a2ea1b972c8b2ea3",
        "status": "terminated",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "scale": "micro",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137257",
              "uri": "http://www.sc.gov.ua/",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
            },
            "address": {
              "countryName": "Україна",
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100"
            },
            "contactPoint": {
              "name": "Сергій Олексюк",
              "telephone": "+380432216930",
              "email": "soleksuk@gmail.com"
            }
          }
        ],
        "milestones": [
          {
            "id": "659cb532d2ad40f1afd8b160f6bf230b",
            "status": "met",
            "type": "activation",
            "dueDate": "2023-05-01T00:00:00+02:00",
            "dateModified": "2023-10-13T01:00:00+03:00"
          }
        ],
        "date": "2023-01-16T00:00:00+02:00"
      }
    ],
    "owner": "test",
    "dateModified": "2023-10-13T01:00:00+03:00",
    "date": "2023-01-16T00:00:00+02:00",
    "dateCreated": "2023-01-16T00:00:00+02:00",
    "id": "6a527caaceb94ad398f77579768a6d67"
  },
  "config": {
    "restricted": false
  }
}

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.