Transparency - Opendata API, version 0.3
This API grants access to all decisions and decrees issued by the Greek public authorities according to the Transparency law. All data is available under a Creative Commons - Attribution license.
The API uses RESTful-like calls and returns the data in XML format, according to the published XSD. The current version (0.3) supports the following operations:
Taxonomies
| Function | URL | Description |
|---|---|---|
| Decision Types | api/types.xml | Returns the Decision Types supported by Transparency. Some types impose additional metadata requirements to the published decisions. |
| Tags | api/tags.xml | Returns the Tags supported by Transparency. Each decision may have several tags. |
| Organizations | api/organizations.xml | Returns the Organizations currently registered with the program. |
| Units | api/units.xml |
Returns the Operational Units of all organizations currently registered with
the program.
It is possible to retrieve the operational units of a single Organization, by using the org parameter, e.g. api/units?org=ypes |
| Signers | api/signers.xml |
Returns the Signers of all published decisions.
If is possible to retrieve the signers of a single Organization, by using the org parameter, e.g. api/signers?org=ypes |
Note: The value of the org parameter is either the Unique ID of the organization (as specified by the uid attribute), or its latin shortcut (as specified by the latin_name element).
Content is returned in XML format by default. It is possible to return it in JSON, by adding the output=json parameter.
Searching decisions
You may search for decisions through the URL:
http://opendata.diavgeia.gov.gr/api/decisions?param1=value1¶m2=value2...
Possible parameters include:
| Parameter | Description | Possible Values |
|---|---|---|
| ada | Returns the decision of the specified Unique Publishing Code (UPC). | The UPC of the decision. |
| org | Returns the decisions issued by the specified Organizations. | Unordered list* of Organizations' UIDs or latin shortcuts. |
| type | Returns the decisions of any of the specified Decision Types. | Unordered list of Decision Types' UIDs. |
| tag | Returns the decisions tagged with any of the specified Tags. | Unordered list of Tags' UIDs. |
| signer | Returns the decisions signed by any of the specified Signer. | Unordered list of Signers' UIDs. |
| datefrom / dateto | Returns the decisions published between the specified dates. | Date in the form: DD-MM-YYYY |
| from / count |
For performance reasons, the number of results returned by the API is limited to
500 decisions, with additional information
about the number of total results being available in the queryInfo element.
You may use the from and count parameters to retrieve additional results.
By default the results are returned in descending publishing time order. Thus, latest decisions will be returned first. |
Integer between 1 and 500. |
| output |
By default the API returns a compact form of the decisions in XML format. The output parameter specifies additional formats:
|
default|full|rss|atom|json|json_full |
| callback |
You may use this parameter for JSONP calls. Its value determines the Javascript callback function. This parameter is used only for the json and json_full types. |
Name of the callback function. |
| order |
By default, the API returns decisions in descending publishing time order. By using this argument, you may specify ascending order instead. This is required to ensure that all decisions are processed in cases where are retrieved by successive API calls. |
asc|desc |
*Unordered list consists of one or more values separated by semicolon (;)
For more information about the available data, see the corresponding XML Schema.
Examples
- diavgeia_spending.py Python script that retrieves all decisions related with spending of public funds, by successive API calls.
Version History
Version 0.3
- Added the active element to the XML Schema, in the definition of OrganizationDescription.
- Return an empty result when the org parameter value does not map to an existent organization. If multiple org parameter values are passed, then the incorrect values are ignored.
- Fixed the encoding of the data that is returned when asking for JSONP results.
- Fixed the non-XML character problem in the XML result data.
- Fixed the RSS/Atom results for non-existent org parameter values. If an invalid organization id or latin name is passed, then an empty feed is created, instead of showing stacktraces.
- Fixed the RSS/Atom results for non-existent org parameter values. If more than organizations are defined, then the resulting feed will have a general title. Again, the invalid org parameter values are ignored.
Version 0.2.1
- Added the callback parameter to the API.
- Added the isCorrectionOfAda and relativeAda elements to the XML schema.
- Filtering the results to strip invalid Unicode characters.
Version 0.2
- Added the order parameter to the API.
- The datefrom and dateto parameters now correspond to the publishing date rather than the paper document date.
- HTTP Error 400 (Invalid arguments) will be returned for all invalid API parameters.
