OCDS Analytics API query examples

Please read the full documentation here

Example 1: A register of procurements initiated by the procuring entity

Query example:

{
  Tenders(
    page: { limit: 3 }
    filters: [
      {
        eq: {
          relatedField: { procuringEntityIdentifier: { field: "id" } }
          value: "37501627"
        }
      }
      { eq: { field: "status", value: "complete" } }
    ]
  ) {
    values {
      tenderID
      title
      items {
        description
      }
      status
      value {
        amount
      }
      suppliers {
        values {
          identifier {
            id
            legalName
          }
        }
      }
    }
  }
}

Result:

{
  "data": {
    "Tenders": {
      "values": [
        {
          "tenderID": "UA-2018-05-24-003328-a",
          "title": "Послуги з поточного ремонту  підлоги коридору  за адресою: вул. Академіка Курчатова, 23-а",
          "items": [
            {
              "description": "Послуги з поточного ремонту  підлоги коридору  за адресою: вул. Академіка Курчатова, 23-а"
            }
          ],
          "status": "complete",
          "value": {
            "amount": 25008
          },
          "suppliers": {
            "values": [
              {
                "identifier": {
                  "id": "40284252",
                  "legalName": "Товариство з обмеженою відповідальністю \"Ерідан Буд\""
                }
              }
            ]
          }
        },
        {
          "tenderID": "UA-2018-04-24-000649-b",
          "title": "Придбання музичного обладнання (мікрофонна радіо система, мікшерний пульт, мікрофон шнуровий, студійний монітор, мікрофонні стійки)",
          "items": [
            {
              "description": "Придбання музичного обладнання (мікрофонна радіо система , мікшерний пульт, мікрофон шнуровий , студійний монітор, мікрофонні стійки)"
            }
          ],
          "status": "complete",
          "value": {
            "amount": 55547
          },
          "suppliers": {
            "values": [
              {
                "identifier": {
                  "id": "2632215296",
                  "legalName": "ФОП ПОПАДЮК ЮРІЙ ГРИГОРОВИЧ"
                }
              }
            ]
          }
        },
        {
          "tenderID": "UA-2018-04-13-000562-c",
          "title": "Капітальний ремонт покрівлі Будинку культури за адресою: м. Київ, вул. Радосинська,27",
          "items": [
            {
              "description": "Капітальний ремонт покрівлі Будинку культури за адресою: м. Київ, вул. Радосинська,27"
            }
          ],
          "status": "complete",
          "value": {
            "amount": 100000
          },
          "suppliers": {
            "values": [
              {
                "identifier": {
                  "id": "39664738",
                  "legalName": "Товариство з обмеженою відповідальністю \" КИЇВСЬКЕ ЕНЕРГО-БУДІВЕЛЬНЕ УПРАВЛІННЯ \""
                }
              }
            ]
          }
        }
      ]
    }
  }
}
Try it

Example 2: A register of procurements the tenderer participated in

Query example:

{
  Tenders(
    page: { limit: 3 }
    filters: [
      {
        eq: {
          relatedField: { tenderersIdentifiers: { field: "id" } }
          value: "39472457"
        }
      }
      { eq: { field: "status", value: "complete" } }
    ]
  ) {
    values {
      procuringEntity {
        id
        name
      }
      tenderID
      title
      items {
        description
      }
      status
      value {
        amount
      }
    }
  }
}

Result:

{
  "data": {
    "Tenders": {
      "values": [
        {
          "procuringEntity": {
            "id": "UA-EDR-01489374",
            "name": "Школа мистецтв Деснянського району міста Києва імені Миколи Дмитровича Леонтовича"
          },
          "tenderID": "UA-2017-12-04-003152-c",
          "title": "Аварійно-поточний ремонт сантехнічного обладнання",
          "items": [
            {
              "description": "Аварійно-поточний ремонт сантехнічного обладнання"
            }
          ],
          "status": "complete",
          "value": {
            "amount": 11119.54
          }
        },
        {
          "procuringEntity": {
            "id": "UA-EDR-37501684",
            "name": "Управління освіти Деснянської районної в місті Києві державної адміністрації"
          },
          "tenderID": "UA-2018-05-29-000640-c",
          "title": "Аварійний поточний ремонт інженерних мереж в дошкільному навчальному закладі (ясла - садок) № 597 комбінованого типу Деснянського району міста Києва за адресою: м. Київ, вул. Шолом - Алейхема, 4-А",
          "items": [
            {
              "description": "Аварійний поточний ремонт інженерних мереж в дошкільному навчальному закладі (ясла - садок) № 597 комбінованого типу Деснянського району міста Києва за адресою: м. Київ, вул. Шолом - Алейхема, 4-А"
            }
          ],
          "status": "complete",
          "value": {
            "amount": 47010.56
          }
        },
        {
          "procuringEntity": {
            "id": "UA-EDR-01489374",
            "name": "Школа мистецтв Деснянського району міста Києва імені Миколи Дмитровича Леонтовича"
          },
          "tenderID": "UA-2018-06-21-001499-a",
          "title": "Поточний аварійний ремонт  будівлі (сміттєзбірника)",
          "items": [
            {
              "description": "Поточний аварійний ремонт  будівлі (сміттєзбірника)"
            }
          ],
          "status": "complete",
          "value": {
            "amount": 49258.99
          }
        }
      ]
    }
  }
}
Try it

Example 3: Top 5 contracts

Query example:

{
  Contracts(
    page: { limit: 5 }
    filters: [
      { eq: { field: "status", value: "active" } }
      { gte: { field: "value.amount", value: "0" } }
    ]
    order: { field: "value.amount", direction: "DESC" }
  ) {
    values {
      contractID
      title
      status
      value {
        amount
      }
    }
  }
}

Result:

{
  "data": {
    "Contracts": {
      "values": [
        {
          "contractID": "UA-2018-10-19-001299-b-b1",
          "title": null,
          "status": "active",
          "value": {
            "amount": 380674522126
          }
        },
        {
          "contractID": "UA-2018-12-20-001661-a-a1",
          "title": null,
          "status": "active",
          "value": {
            "amount": 380672491655
          }
        },
        {
          "contractID": "UA-2016-10-06-000766-b-b1",
          "title": null,
          "status": "active",
          "value": {
            "amount": 380504693192
          }
        },
        {
          "contractID": "UA-2017-12-15-005049-b-b1",
          "title": null,
          "status": "active",
          "value": {
            "amount": 380347260102
          }
        },
        {
          "contractID": "UA-2018-10-31-000245-b-a1",
          "title": null,
          "status": "active",
          "value": {
            "amount": 19089768403
          }
        }
      ]
    }
  }
}
Try it

Example 4: Top 5 suppliers

Query example:

{
  Organizations(
    page: { limit: 5 }
    order: {
      aggregation: { sum: { contractsAsSupplier: { field: "value.amount" } } }
      direction: "DESC"
    }
    filters: {
      eq: {
        relatedField: { contractsAsSupplier: { field: "status" } }
        value: "active"
      }
    }
  ) {
    values {
      id
      name
      contracts {
        aggregation {
          sum(params: { field: "value.amount" })
          count
        }
      }
    }
  }
}

Result:

{
  "data": {
    "Organizations": {
      "values": [
        {
          "id": "UA-EDR-31729022",
          "name": "СЕЛЯНСЬКЕ (ФЕРМЕРСЬКЕ) ГОСПОДАРСТВО \"КОМПРОМІС\"",
          "contracts": {
            "aggregation": {
              "sum": 380674739703.5,
              "count": 20
            }
          }
        },
        {
          "id": "UA-EDR-3013923104",
          "name": "Лозан Євгенія Олегівна ",
          "contracts": {
            "aggregation": {
              "sum": 380673772773,
              "count": 43
            }
          }
        },
        {
          "id": "UA-EDR-34795810",
          "name": "ТОВ \"Вікно-маркет\"",
          "contracts": {
            "aggregation": {
              "sum": 380505357855.8789,
              "count": 26
            }
          }
        },
        {
          "id": "UA-EDR-3183318943",
          "name": "Іваницька Вероніка Володимирівна",
          "contracts": {
            "aggregation": {
              "sum": 380347866316.09,
              "count": 115
            }
          }
        },
        {
          "id": "UA-EDR-20077720",
          "name": "АКЦІОНЕРНЕ ТОВАРИСТВО \"НАЦІОНАЛЬНА АКЦІОНЕРНА КОМПАНІЯ \"НАФТОГАЗ УКРАЇНИ\"",
          "contracts": {
            "aggregation": {
              "sum": 43840117906.27587,
              "count": 647
            }
          }
        }
      ]
    }
  }
}
Try it

Example 5: Top 5 procuring entities

Query example:

{
  Organizations(
    page: { limit: 5 }
    order: {
      aggregation: {
        sum: { contractsAsProcuringEntity: { field: "value.amount" } }
      }
      direction: "DESC"
    }
    filters: {
      eq: {
        relatedField: { contractsAsProcuringEntity: { field: "status" } }
        value: "active"
      }
    }
  ) {
    values {
      id
      name
      contracts {
        aggregation {
          sum(params: { field: "value.amount" })
          count
        }
      }
    }
  }
}

Result:

{
  "data": {
    "Organizations": {
      "values": [
        {
          "id": "UA-EDR-40108981",
          "name": "Центр обслуговування підрозділів Національної поліції України",
          "contracts": {
            "aggregation": {
              "sum": 380783812019.6339,
              "count": 3576
            }
          }
        },
        {
          "id": "UA-EDR-03189311",
          "name": "КОМУНАЛЬНИЙ ЗАКЛАД \"ЗДОЛБУНІВСЬКИЙ БУДИНОК-ІНТЕРНАТ ДЛЯ ГРОМАДЯН ПОХИЛОГО ВІКУ ТА ІНВАЛІДІВ\" РІВНЕНСЬКОЇ ОБЛАСНОЇ РАДИ",
          "contracts": {
            "aggregation": {
              "sum": 380692402957.6521,
              "count": 410
            }
          }
        },
        {
          "id": "UA-EDR-03191561",
          "name": "Центр підвищення кваліфікації працівників сфери управління Міністерства соціальної політики України",
          "contracts": {
            "aggregation": {
              "sum": 380507493292.61523,
              "count": 80
            }
          }
        },
        {
          "id": "UA-EDR-02143459",
          "name": "Управління освіти Калуської міської ради",
          "contracts": {
            "aggregation": {
              "sum": 380357677759.44604,
              "count": 166
            }
          }
        },
        {
          "id": "UA-EDR-30019775",
          "name": "АТ \"Укргазвидобування\"",
          "contracts": {
            "aggregation": {
              "sum": 70095167181.63931,
              "count": 3765
            }
          }
        }
      ]
    }
  }
}
Try it