Application programming interface (API)
The SDG API (Application Programming Interface) allows to browse and download for further processing the full range of data and metadata for global and national indicators monitoring the Sustainable Development Goals (SDGs) of the 2030 Agenda in Poland.
Limits and API key
For API security reasons, quantitative limits are imposed on the number of requests. For unauthenticated requests, the rate limit allows for up to 60 requests per hour. For API requests using OAuth, you can make up to 5000 requests per hour. To use OAuth, you need to create account on Github and generate personal access token in developer settings. Then set the Authorization header with token in your request. For example:
curl -H "Accept:application/vnd.github.v3.raw" -H "Authorization: token generated_token" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/global/1/1-1-1.json"
For more information, please visit:help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line developer.github.com/v3/auth/
Response status codes
Status code Definition Message
200 OK
The request was successful and the response body contains the representation requested
302 FOUND
A common redirect response; you can GET the representation at the URI in the Location response header
304 NOT MODIFIED
There is no new data to return
400 BAD REQUEST
The request was invalid or cannot be otherwise served
401 UNAUTHORIZED
The authentication credentials are missing, or if supplied are not valid or not sufficient to access the resource
403 FORBIDDEN
The request has been refused
404 NOT FOUND
The URI requested is invalid or the resource requested does not exists
406 NOT ACCEPTABLE
The request specified an invalid format
410 GONE
This resource is gone
500 INTERNAL SERVER ERROR
Something is horribly wrong
502 BAD GATEWAY
The service is down or being upgraded
503 SERVICE UNAVAILABLE
The service is up, but overloaded with requests
504 GATEWAY TIMEOUT
Servers are up, but the request couldn’t be serviced due to some failure within our stack
GET /api/v1/en/custodian/cbd.json
This method allows users to download data and metadata for all CBD global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/cbd.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/cbd.json
Response code
200
Response
GET /api/v1/en/custodian/cites.json
This method allows users to download data and metadata for all CITES global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/cites.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/cites.json
Response code
200
Response
GET /api/v1/en/custodian/desa-financing.json
This method allows users to download data and metadata for all DESA-Financing global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/desa-financing.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/desa-financing.json
Response code
200
Response
GET /api/v1/en/custodian/desa-popdiv.json
This method allows users to download data and metadata for all DESA-PopDiv global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/desa-popdiv.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/desa-popdiv.json
Response code
200
Response
GET /api/v1/en/custodian/desa-unsd.json
This method allows users to download data and metadata for all DESA-UNSD global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/desa-unsd.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/desa-unsd.json
Response code
200
Response
GET /api/v1/en/custodian/fao.json
This method allows users to download data and metadata for all FAO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/fao.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/fao.json
Response code
200
Response
GET /api/v1/en/custodian/icao.json
This method allows users to download data and metadata for all ICAO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/icao.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/icao.json
Response code
200
Response
GET /api/v1/en/custodian/iea.json
This method allows users to download data and metadata for all IEA global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/iea.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/iea.json
Response code
200
Response
GET /api/v1/en/custodian/ilo.json
This method allows users to download data and metadata for all ILO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ilo.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ilo.json
Response code
200
Response
GET /api/v1/en/custodian/imf.json
This method allows users to download data and metadata for all IMF global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/imf.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/imf.json
Response code
200
Response
GET /api/v1/en/custodian/iom.json
This method allows users to download data and metadata for all IOM global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/iom.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/iom.json
Response code
200
Response
GET /api/v1/en/custodian/ipu.json
This method allows users to download data and metadata for all IPU global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ipu.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ipu.json
Response code
200
Response
GET /api/v1/en/custodian/itc.json
This method allows users to download data and metadata for all ITC global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/itc.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/itc.json
Response code
200
Response
GET /api/v1/en/custodian/itu.json
This method allows users to download data and metadata for all ITU global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/itu.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/itu.json
Response code
200
Response
GET /api/v1/en/custodian/iucn.json
This method allows users to download data and metadata for all IUCN global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/iucn.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/iucn.json
Response code
200
Response
GET /api/v1/en/custodian/oecd.json
This method allows users to download data and metadata for all OECD global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/oecd.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/oecd.json
Response code
200
Response
GET /api/v1/en/custodian/oecd-development.json
This method allows users to download data and metadata for all OECD-Development global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/oecd-development.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/oecd-development.json
Response code
200
Response
GET /api/v1/en/custodian/ohchr.json
This method allows users to download data and metadata for all OHCHR global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ohchr.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ohchr.json
Response code
200
Response
GET /api/v1/en/custodian/paris21.json
This method allows users to download data and metadata for all PARIS21 global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/paris21.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/paris21.json
Response code
200
Response
GET /api/v1/en/custodian/ramsar.json
This method allows users to download data and metadata for all Ramsar global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ramsar.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/ramsar.json
Response code
200
Response
GET /api/v1/en/custodian/un-doalos.json
This method allows users to download data and metadata for all UN-DOALOS global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/un-doalos.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/un-doalos.json
Response code
200
Response
GET /api/v1/en/custodian/un-habitat.json
This method allows users to download data and metadata for all UN-Habitat global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/un-habitat.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/un-habitat.json
Response code
200
Response
GET /api/v1/en/custodian/unaids.json
This method allows users to download data and metadata for all UNAIDS global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unaids.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unaids.json
Response code
200
Response
GET /api/v1/en/custodian/unccd.json
This method allows users to download data and metadata for all UNCCD global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unccd.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unccd.json
Response code
200
Response
GET /api/v1/en/custodian/unctad.json
This method allows users to download data and metadata for all UNCTAD global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unctad.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unctad.json
Response code
200
Response
GET /api/v1/en/custodian/undp.json
This method allows users to download data and metadata for all UNDP global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/undp.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/undp.json
Response code
200
Response
GET /api/v1/en/custodian/undrr.json
This method allows users to download data and metadata for all UNDRR global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/undrr.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/undrr.json
Response code
200
Response
GET /api/v1/en/custodian/unece.json
This method allows users to download data and metadata for all UNECE global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unece.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unece.json
Response code
200
Response
GET /api/v1/en/custodian/unep.json
This method allows users to download data and metadata for all UNEP global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unep.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unep.json
Response code
200
Response
GET /api/v1/en/custodian/unep-wcmc.json
This method allows users to download data and metadata for all UNEP-WCMC global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unep-wcmc.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unep-wcmc.json
Response code
200
Response
GET /api/v1/en/custodian/unesco.json
This method allows users to download data and metadata for all UNESCO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unesco.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unesco.json
Response code
200
Response
GET /api/v1/en/custodian/unesco-ioc.json
This method allows users to download data and metadata for all UNESCO-IOC global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unesco-ioc.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unesco-ioc.json
Response code
200
Response
GET /api/v1/en/custodian/unesco-uis.json
This method allows users to download data and metadata for all UNESCO-UIS global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unesco-uis.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unesco-uis.json
Response code
200
Response
GET /api/v1/en/custodian/unfccc.json
This method allows users to download data and metadata for all UNFCCC global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unfccc.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unfccc.json
Response code
200
Response
GET /api/v1/en/custodian/unfpa.json
This method allows users to download data and metadata for all UNFPA global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unfpa.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unfpa.json
Response code
200
Response
GET /api/v1/en/custodian/unicef.json
This method allows users to download data and metadata for all UNICEF global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unicef.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unicef.json
Response code
200
Response
GET /api/v1/en/custodian/unido.json
This method allows users to download data and metadata for all UNIDO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unido.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unido.json
Response code
200
Response
GET /api/v1/en/custodian/unodc.json
This method allows users to download data and metadata for all UNODC global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unodc.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unodc.json
Response code
200
Response
GET /api/v1/en/custodian/unwto.json
This method allows users to download data and metadata for all UNWTO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unwto.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unwto.json
Response code
200
Response
GET /api/v1/en/custodian/unwoman.json
This method allows users to download data and metadata for all UNWoman global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unwoman.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/unwoman.json
Response code
200
Response
GET /api/v1/en/custodian/who.json
This method allows users to download data and metadata for all WHO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/who.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/who.json
Response code
200
Response
GET /api/v1/en/custodian/who-fctc.json
This method allows users to download data and metadata for all WHO-FCTC global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/who-fctc.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/who-fctc.json
Response code
200
Response
GET /api/v1/en/custodian/wto.json
This method allows users to download data and metadata for all WTO global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/wto.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/wto.json
Response code
200
Response
GET /api/v1/en/custodian/world-bank.json
This method allows users to download data and metadata for all World-Bank global indicators in English.
Parameters
No input parameters
Response content type
application/json
Curl example
curl -H "Accept:application/vnd.github.v3.raw" "https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/world-bank.json"
URL example
https://api.github.com/repos/statisticspoland/sdg-indicators-pl/contents/api/v1/en/custodian/world-bank.json
Response code
200
Response
