Diavgis — Greek Public Procurement

Search Greek public-procurement acts across THREE cross-linked sources — Διαύγεια, ΚΗΜΔΗΣ (Central Electronic Public Procurement Registry) and EU TED. Filter by source (diavgeia|kimdis|ted), lifecycle status (request|tender|award|contract|payment), buyer or supplier ΑΦΜ (9-digit tax id), CPV code, EUR budget range, NUTS region, submission deadline (deadline_after=TODAY + status=tender ⇒ the OPEN tenders a supplier can still bid on), free-text q over the act title, and procurement signals (published facts from ΚΗΜΔΗΣ): direct_award (απευθείας ανάθεση), single_bidder (≤1 bid on the contract), cancelled. Returns a paginated envelope; 'next' is the next PAGE NUMBER or null. Natural-person counterparties are redacted. Do NOT sum amount_net across results to get spend — use rank_entities or spend_by_cpv, which count each procurement once.

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "enum": [
        "diavgeia",
        "kimdis",
        "ted"
      ],
      "description": "filter by data source"
    },
    "status": {
      "type": "string",
      "enum": [
        "request",
        "tender",
        "award",
        "contract",
        "payment"
      ]
    },
    "buyer_afm": {
      "type": "string",
      "description": "9-digit buyer ΑΦΜ"
    },
    "supplier_afm": {
      "type": "string",
      "description": "9-digit supplier ΑΦΜ"
    },
    "cpv": {
      "type": "string",
      "description": "CPV code (e.g. 79710000)"
    },
    "budget_min": {
      "type": "number",
      "description": "minimum amount_net in EUR"
    },
    "budget_max": {
      "type": "number",
      "description": "maximum amount_net in EUR"
    },
    "year": {
      "type": "string",
      "description": "4-digit issue year, e.g. 2026 — restricts to acts issued that year"
    },
    "q": {
      "type": "string",
      "description": "free-text search over the act title"
    },
    "direct_award": {
      "type": "boolean",
      "description": "only direct awards (procedure = απευθείας ανάθεση) — a published ΚΗΜΔΗΣ fact"
    },
    "single_bidder": {
      "type": "boolean",
      "description": "only contracts where ≤1 bid was submitted (maxBidsSubmitted; single bidder)"
    },
    "price_only": {
      "type": "boolean",
      "description": "only awards/contracts decided on lowest-price alone (award_criteria = Βάσει τιμής / Χαμηλότερη Τιμή), excluding most-economically-advantageous (MEAT) criteria"
    },
    "cancelled": {
      "type": "boolean",
      "description": "only acts the source marked as cancelled"
    },
    "has_chain": {
      "type": "boolean",
      "description": "only acts linked into a reconstructed lifecycle chain (request→tender→award→contract→payment)"
    },
    "deadline_after": {
      "type": "string",
      "description": "ISO date (YYYY-MM-DD). Only acts whose submission deadline is on/after this date. Pass TODAY to get OPEN tenders — the ones a supplier can still bid on. Combine with status=\"tender\"."
    },
    "region": {
      "type": "string",
      "description": "NUTS region code prefix, e.g. EL30 (Attica), EL52 (Central Macedonia). Matches by prefix, so EL3 covers all of Attica."
    },
    "page": {
      "type": "number",
      "description": "1-based page number; pagination DEPTH is capped per plan"
    },
    "page_size": {
      "type": "number",
      "description": "max 200"
    }
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "canonical act id — Διαύγεια ΑΔΑ, 'kimdis:<ΑΔΑΜ>' or 'ted:<publication-number>'"
          },
          "ada": {
            "type": [
              "string",
              "null"
            ],
            "description": "Διαύγεια ΑΔΑ"
          },
          "adam": {
            "type": [
              "string",
              "null"
            ],
            "description": "ΚΗΜΔΗΣ ΑΔΑΜ"
          },
          "esidis_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "ΕΣΗΔΗΣ system id when published"
          },
          "kind": {
            "type": "string",
            "enum": [
              "request",
              "tender",
              "award",
              "contract",
              "payment"
            ],
            "description": "lifecycle stage"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "buyer_afm": {
            "type": [
              "string",
              "null"
            ],
            "description": "9-digit ΑΦΜ of the contracting authority"
          },
          "buyer_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "supplier_afm": {
            "type": [
              "string",
              "null"
            ],
            "description": "null when the counterparty is a redacted natural person"
          },
          "cpv_primary": {
            "type": [
              "string",
              "null"
            ],
            "description": "primary CPV code"
          },
          "nuts": {
            "type": [
              "string",
              "null"
            ],
            "description": "NUTS region code"
          },
          "amount_net": {
            "type": [
              "number",
              "null"
            ],
            "description": "EUR excluding VAT"
          },
          "amount_gross": {
            "type": [
              "number",
              "null"
            ],
            "description": "EUR including VAT"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "deadline": {
            "type": [
              "string",
              "null"
            ],
            "description": "tender submission deadline (YYYY-MM-DD)"
          },
          "issued_at": {
            "type": "string",
            "description": "ISO-8601 issue timestamp"
          },
          "source": {
            "type": "string",
            "enum": [
              "diavgeia",
              "kimdis",
              "ted"
            ]
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "permalink to the authoritative source record"
          },
          "redacted": {
            "type": "boolean",
            "description": "true when the counterparty is a natural person (GDPR)"
          },
          "bids_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "bids submitted (ΚΗΜΔΗΣ maxBidsSubmitted)"
          },
          "procedure_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ν.4412 procedure as published (Απευθείας ανάθεση, Ανοιχτή διαδικασία, …)"
          },
          "award_procedure": {
            "type": [
              "string",
              "null"
            ],
            "description": "statutory exception (art. 32 ν.4412/2016) the buyer invoked to skip a competitive call. Published on ~100% of «negotiated without prior publication» / «competitive procedure with negotiation» / «competitive dialogue» acts and on ~0% of others — so null means NOT REQUIRED, not missing, except on those three procedures where it is a genuine anomaly."
          },
          "amount_check": {
            "type": [
              "string",
              "null"
            ],
            "description": "JSON verdict when the published amount looks wrong, e.g. {\"outcome\":\"scale_suspect\",\"original\":809100000}"
          },
          "contract_budget_net": {
            "type": [
              "number",
              "null"
            ],
            "description": "the document's own approved budget — compare with amount_net to spot cumulative/typo figures"
          },
          "award_criteria": {
            "type": [
              "string",
              "null"
            ]
          },
          "cancelled": {
            "type": "boolean"
          },
          "revoked": {
            "type": "boolean"
          },
          "chain_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "lifecycle chain this act belongs to, null if unlinked"
          }
        },
        "required": [
          "id",
          "kind",
          "issued_at",
          "source",
          "redacted"
        ]
      }
    },
    "page": {
      "type": "number"
    },
    "page_size": {
      "type": "number"
    },
    "total": {
      "type": "number",
      "description": "total acts matching the filters"
    },
    "next": {
      "type": [
        "number",
        "null"
      ],
      "description": "next page NUMBER, or null when there are no more pages — not a URL"
    }
  },
  "required": [
    "data",
    "page",
    "page_size",
    "total",
    "next"
  ]
}

Greek public contracts that are RUNNING NOW and expire within a horizon of 0, 7, 30 or 180 days — the renewal pipeline. Each row carries who currently holds the contract and HOW it was awarded (direct award vs competitive tender, and the number of bids where the source reports it), which is what tells you whether the re-tender is worth chasing. One procurement is counted ONCE: Greek sources publish the duration on the award record as well as the contract, so award records are dropped when a contract in the same lifecycle chain already defines the expiry. ⚠ `expiry_basis` on every row states how the date was obtained — `published` (the buyer published an end date), `computed_from_start` (start date + declared duration) or `computed_from_publication` (no start date published, so the publication date was substituted; systematically early). Do not present a computed date as a published one. ACCESS: horizon 0 (expiring today) is free on every plan and returns the complete record. Horizons 7/30/180 require a paid plan — lead time is the paid product.

{
  "type": "object",
  "properties": {
    "h": {
      "type": "number",
      "enum": [
        0,
        7,
        30,
        180
      ],
      "description": "horizon in days; 0 = expiring today (free on every plan). Default 180."
    },
    "cpv": {
      "type": "string",
      "description": "CPV division, 2 digits (e.g. 33 for medical equipment)"
    },
    "region": {
      "type": "string",
      "description": "NUTS code, e.g. EL30 for Attica"
    },
    "page_size": {
      "type": "number",
      "description": "rows to return, 1-200 (default 50)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "horizon_days": {
      "type": "number"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "buyer_afm": {
            "type": [
              "string",
              "null"
            ]
          },
          "buyer_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "supplier_afm": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount_net": {
            "type": [
              "number",
              "null"
            ],
            "description": "EUR, excludes VAT"
          },
          "cpv_primary": {
            "type": [
              "string",
              "null"
            ]
          },
          "nuts": {
            "type": [
              "string",
              "null"
            ]
          },
          "contract_end": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO date the contract stops running"
          },
          "source": {
            "type": "string"
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "source"
        ]
      }
    },
    "page": {
      "type": "number"
    },
    "page_size": {
      "type": "number"
    },
    "total": {
      "type": "number"
    },
    "next": {
      "type": [
        "number",
        "null"
      ],
      "description": "next page NUMBER, or null at the end"
    }
  },
  "required": [
    "data",
    "page",
    "page_size",
    "total",
    "next"
  ]
}

Full detail of one act by its id (Διαύγεια ΑΔΑ, ΚΗΜΔΗΣ 'kimdis:<ΑΔΑΜ>', or TED 'ted:<number>'): canonical fields, resolved buyer/supplier entities, CPV codes with labels, and its cross-source lifecycle chain if linked. On ΚΗΜΔΗΣ contracts, `commitment_ada` carries the Διαύγεια ΑΔΑ of the budget-commitment decision the source declares (comma-separated when more than one). It is a pointer INTO Διαύγεια, not an act we necessarily hold — resolve it at diavgeia.gov.gr, not through this API — and it is deliberately NOT a chain edge: one annual commitment funds many unrelated contracts.

{
  "type": "object",
  "properties": {
    "ada": {
      "type": "string",
      "description": "act id — ΑΔΑ, 'kimdis:<ΑΔΑΜ>' or 'ted:<number>'"
    }
  },
  "required": [
    "ada"
  ]
}

{
  "type": "object",
  "properties": {
    "act": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "canonical act id — Διαύγεια ΑΔΑ, 'kimdis:<ΑΔΑΜ>' or 'ted:<publication-number>'"
        },
        "ada": {
          "type": [
            "string",
            "null"
          ],
          "description": "Διαύγεια ΑΔΑ"
        },
        "adam": {
          "type": [
            "string",
            "null"
          ],
          "description": "ΚΗΜΔΗΣ ΑΔΑΜ"
        },
        "esidis_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "ΕΣΗΔΗΣ system id when published"
        },
        "kind": {
          "type": "string",
          "enum": [
            "request",
            "tender",
            "award",
            "contract",
            "payment"
          ],
          "description": "lifecycle stage"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "buyer_afm": {
          "type": [
            "string",
            "null"
          ],
          "description": "9-digit ΑΦΜ of the contracting authority"
        },
        "buyer_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "supplier_afm": {
          "type": [
            "string",
            "null"
          ],
          "description": "null when the counterparty is a redacted natural person"
        },
        "cpv_primary": {
          "type": [
            "string",
            "null"
          ],
          "description": "primary CPV code"
        },
        "nuts": {
          "type": [
            "string",
            "null"
          ],
          "description": "NUTS region code"
        },
        "amount_net": {
          "type": [
            "number",
            "null"
          ],
          "description": "EUR excluding VAT"
        },
        "amount_gross": {
          "type": [
            "number",
            "null"
          ],
          "description": "EUR including VAT"
        },
        "currency": {
          "type": [
            "string",
            "null"
          ]
        },
        "deadline": {
          "type": [
            "string",
            "null"
          ],
          "description": "tender submission deadline (YYYY-MM-DD)"
        },
        "issued_at": {
          "type": "string",
          "description": "ISO-8601 issue timestamp"
        },
        "source": {
          "type": "string",
          "enum": [
            "diavgeia",
            "kimdis",
            "ted"
          ]
        },
        "source_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "permalink to the authoritative source record"
        },
        "redacted": {
          "type": "boolean",
          "description": "true when the counterparty is a natural person (GDPR)"
        },
        "bids_count": {
          "type": [
            "number",
            "null"
          ],
          "description": "bids submitted (ΚΗΜΔΗΣ maxBidsSubmitted)"
        },
        "procedure_type": {
          "type": [
            "string",
            "null"
          ],
          "description": "Ν.4412 procedure as published (Απευθείας ανάθεση, Ανοιχτή διαδικασία, …)"
        },
        "award_procedure": {
          "type": [
            "string",
            "null"
          ],
          "description": "statutory exception (art. 32 ν.4412/2016) the buyer invoked to skip a competitive call. Published on ~100% of «negotiated without prior publication» / «competitive procedure with negotiation» / «competitive dialogue» acts and on ~0% of others — so null means NOT REQUIRED, not missing, except on those three procedures where it is a genuine anomaly."
        },
        "amount_check": {
          "type": [
            "string",
            "null"
          ],
          "description": "JSON verdict when the published amount looks wrong, e.g. {\"outcome\":\"scale_suspect\",\"original\":809100000}"
        },
        "contract_budget_net": {
          "type": [
            "number",
            "null"
          ],
          "description": "the document's own approved budget — compare with amount_net to spot cumulative/typo figures"
        },
        "award_criteria": {
          "type": [
            "string",
            "null"
          ]
        },
        "cancelled": {
          "type": "boolean"
        },
        "revoked": {
          "type": "boolean"
        },
        "chain_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "lifecycle chain this act belongs to, null if unlinked"
        }
      },
      "required": [
        "id",
        "kind",
        "issued_at",
        "source",
        "redacted"
      ]
    },
    "buyer": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "afm": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "kind": {
          "type": "string"
        }
      }
    },
    "supplier": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "afm": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "kind": {
          "type": "string"
        }
      }
    },
    "cpvs": {
      "type": "array",
      "description": "CPV classifications with their official Greek labels",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "label": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "code"
        ]
      }
    },
    "chain": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "chain_id": {
          "type": "string"
        },
        "members": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "ada": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "amount_net": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "ada"
            ]
          }
        }
      }
    }
  },
  "required": [
    "act",
    "buyer",
    "supplier",
    "cpvs",
    "chain"
  ]
}

Profile of a legal entity (company or public body) by 9-digit ΑΦΜ: name, role, and spend/receipt statistics as buyer and as supplier. EUR totals = the COMMITTED procurement value counted ONCE per procurement (deduplicated across ΚΗΜΔΗΣ/Διαύγεια sources and the award→contract→payment lifecycle; tenders/budgets excluded), so it reflects real committed spend, not a sum of every published act.

{
  "type": "object",
  "properties": {
    "afm": {
      "type": "string",
      "description": "9-digit ΑΦΜ"
    }
  },
  "required": [
    "afm"
  ]
}

{
  "type": "object",
  "properties": {
    "afm": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "description": "buyer | supplier"
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ]
    },
    "last_seen": {
      "type": [
        "string",
        "null"
      ]
    },
    "stats": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "acts_as_buyer": {
          "type": "number"
        },
        "acts_as_supplier": {
          "type": "number"
        },
        "spent_as_buyer": {
          "type": "number",
          "description": "EUR committed as contracting authority"
        },
        "received_as_supplier": {
          "type": "number",
          "description": "EUR committed to this supplier"
        }
      }
    }
  },
  "required": [
    "afm",
    "name",
    "stats"
  ]
}

A reconstructed procurement lifecycle chain by chain_id: the linked sequence of related acts (e.g. commitment → award → contract → payments) with confidence and link method. Get a chain_id from the chain_id field of any act. A chain is ONE procurement's lifecycle, not everything an act references: an administrative umbrella cited by more than 25 acts (e.g. one annual expense-approval decision referenced by thousands of a buyer's acts) is deliberately NOT merged, so a chain never swallows a year of unrelated activity. Those references are still published — see the act's own references — they simply do not form a chain.

{
  "type": "object",
  "properties": {
    "chain_id": {
      "type": "string"
    }
  },
  "required": [
    "chain_id"
  ]
}

{
  "type": "object",
  "properties": {
    "chain_id": {
      "type": "string"
    },
    "members": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ada": {
            "type": "string",
            "description": "act id of the member"
          },
          "role": {
            "type": [
              "string",
              "null"
            ]
          },
          "confidence": {
            "type": [
              "number",
              "null"
            ]
          },
          "method": {
            "type": [
              "string",
              "null"
            ],
            "description": "how the link was made: id | fuzzy | cross | semantic | manual"
          },
          "kind": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount_net": {
            "type": [
              "number",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "issued_at": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "ada"
        ]
      }
    }
  },
  "required": [
    "chain_id",
    "members"
  ]
}

Rank top Greek public-procurement entities. role=buyer (default) or supplier; by=spend (default — COMMITTED procurement value in EUR, counted ONCE per procurement: deduplicated across sources and lifecycle stages, tenders excluded), single_bidder (count of ≤1-bid awards/contracts) or direct_award (count of απευθείας ανάθεση). Answers 'top 10 suppliers by public revenue', 'which buyers award most without competition'. Returns afm, name, metric, total. Precomputed and refreshed every 6 hours, so it is instant and always the top 15.

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "enum": [
        "buyer",
        "supplier"
      ],
      "description": "default buyer"
    },
    "by": {
      "type": "string",
      "enum": [
        "spend",
        "single_bidder",
        "direct_award"
      ],
      "description": "default spend"
    },
    "limit": {
      "type": "number",
      "description": "max 15, default 15 — the published ranking holds the top 15"
    }
  }
}

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "enum": [
        "buyer",
        "supplier"
      ]
    },
    "by": {
      "type": "string",
      "enum": [
        "spend",
        "single_bidder",
        "direct_award"
      ]
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "afm": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "metric": {
            "type": [
              "number",
              "null"
            ],
            "description": "EUR when by=spend, otherwise a count of acts"
          },
          "total": {
            "type": [
              "number",
              "null"
            ],
            "description": "total acts for this entity in the ranked set"
          }
        },
        "required": [
          "afm"
        ]
      }
    }
  },
  "required": [
    "role",
    "by",
    "results"
  ]
}

Committed public procurement value by CPV category (2-digit division), optionally for one year. Value = counted ONCE per procurement (deduplicated across sources and award/contract/payment stages; tenders excluded). Answers 'what does the Greek state spend the most on'. Returns cpv_division, acts, spend (EUR) for the top divisions by spend — precomputed nightly, so it is instant. Use search_tenders with cpv= for divisions outside the top list.

{
  "type": "object",
  "properties": {
    "year": {
      "type": "string",
      "description": "4-digit year; omit for all-time"
    }
  }
}

{
  "type": "object",
  "properties": {
    "year": {
      "type": "string",
      "description": "the year filtered on, or 'all'"
    },
    "divisions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cpv_division": {
            "type": [
              "string",
              "null"
            ],
            "description": "2-digit CPV division"
          },
          "acts": {
            "type": "number"
          },
          "spend": {
            "type": "number",
            "description": "EUR"
          }
        },
        "required": [
          "cpv_division",
          "acts",
          "spend"
        ]
      }
    }
  },
  "required": [
    "year",
    "divisions"
  ]
}

Resolve a Greek buyer or supplier NAME to its ΑΦΜ. Use this first whenever you have a name but no ΑΦΜ — get_entity, entity_counterparties and the buyer_afm/supplier_afm filters all need the 9-digit number. Matching is accent- and case-insensitive; returns the closest names with their ΑΦΜ, so pick the right one before calling anything else.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full or partial name, e.g. \"Δήμος Αθηναίων\". Accents and case are ignored."
    },
    "kind": {
      "type": "string",
      "enum": [
        "buyer",
        "supplier",
        "both"
      ],
      "description": "Restrict to public bodies (buyer) or companies (supplier). Omit for all."
    },
    "limit": {
      "type": "number",
      "description": "1-20, default 8"
    }
  },
  "required": [
    "name"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "afm": {
            "type": "string",
            "description": "pass this to get_entity / buyer_afm / supplier_afm"
          },
          "name": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "buyer",
              "supplier",
              "both"
            ]
          },
          "first_seen": {
            "type": "string"
          },
          "last_seen": {
            "type": "string"
          }
        },
        "required": [
          "afm",
          "name",
          "kind"
        ]
      }
    }
  },
  "required": [
    "query",
    "matches"
  ]
}

What this API key is allowed to do right now: plan, calls used this period, calls remaining, per-minute rate, page-size and pagination caps, and when the period resets. Free — this call is not counted against the quota. Check it before starting a long job so you can size the work instead of hitting a wall mid-task.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "enum": [
        "free",
        "pro",
        "business"
      ]
    },
    "used": {
      "type": "number",
      "description": "calls consumed this period (REST + MCP share one counter)"
    },
    "limit": {
      "type": [
        "number",
        "null"
      ],
      "description": "monthly quota, null if unlimited"
    },
    "remaining": {
      "type": [
        "number",
        "null"
      ]
    },
    "rate_per_min": {
      "type": "number"
    },
    "max_page_size": {
      "type": "number"
    },
    "max_pages": {
      "type": "number",
      "description": "pagination depth cap; deeper pages return an error, narrow with filters instead"
    },
    "period_reset": {
      "type": "string",
      "description": "ISO date when used resets to 0"
    },
    "pricing_url": {
      "type": "string"
    }
  },
  "required": [
    "plan",
    "used",
    "rate_per_min",
    "max_page_size",
    "max_pages",
    "period_reset"
  ]
}

Top counterparties of an entity (ΑΦΜ): for a buyer, the suppliers it pays most; for a supplier, its top public buyers — with act counts and EUR totals. The 'who does business with whom' due-diligence view.

{
  "type": "object",
  "properties": {
    "afm": {
      "type": "string",
      "description": "9-digit ΑΦΜ"
    },
    "limit": {
      "type": "number",
      "description": "max 30, default 10"
    }
  },
  "required": [
    "afm"
  ]
}

{
  "type": "object",
  "properties": {
    "afm": {
      "type": "string"
    },
    "counterparties": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "afm": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "role": {
            "type": "string",
            "enum": [
              "buyer",
              "supplier"
            ],
            "description": "the role the COUNTERPARTY plays"
          },
          "acts": {
            "type": "number"
          },
          "amount": {
            "type": [
              "number",
              "null"
            ],
            "description": "EUR summed over the shared acts"
          }
        },
        "required": [
          "afm",
          "role",
          "acts"
        ]
      }
    }
  },
  "required": [
    "afm",
    "counterparties"
  ]
}