Public data,ready for code.
Query accepted datasets, categories, and verified publishers as JSON. Public reads require no account or API key.
No key
Public read endpoints
JSON
Structured responses
OpenAPI 3.0
Machine-readable contract
Start withone public query.
This request returns the five latest accepted datasets. Add filters only when you need to narrow the catalogue.
Base URL
https://uod-server.aistudio.ugcurl --get "https://uod-server.aistudio.ug/datasets" \
--data-urlencode "limit=5" \
--data-urlencode "sortBy=submissionDate" \
--data-urlencode "sortOrder=DESC"A small surface,built for useful work.
These endpoints expose published records only. Submission, review, and administration remain protected operations.
GET/datasetsList and filter accepted public datasets
Paginated dataset records
/datasetsList and filter accepted public datasets
Request parameters
- title · optional string
- categoryId · optional UUID
- institutionId · optional UUID
- tags · optional string array
- page · optional number, default 1
- limit · optional number, default 20
- sortBy · title, submissionDate, lastUpdatedAt, or reviewDate
- sortOrder · ASC or DESC
Example path
/datasets?page=1&limit=20&sortOrder=DESCResponse contract
{ datasets: PublicDataset[], total: number, page: number, limit: number }200 OK · 400 Invalid query
GET/datasets/{id}Retrieve one dataset and its metadata
Dataset record
/datasets/{id}Retrieve one dataset and its metadata
Request parameters
- id · required UUID path parameter
Example path
/datasets/{id}Response contract
PublicDataset200 OK · 400 Invalid UUID · 404 Not found
GET/categoriesList public data domains
Category records
/categoriesList public data domains
Request parameters
None.
Example path
/categoriesResponse contract
Category[]200 OK
GET/categories/{id}Retrieve one public data domain
Category record
/categories/{id}Retrieve one public data domain
Request parameters
- id · required UUID path parameter
Example path
/categories/{id}Response contract
Category200 OK · 400 Invalid UUID · 404 Not found
GET/institutionsList verified publishers and publication totals
Publisher summaries
/institutionsList verified publishers and publication totals
Request parameters
None.
Example path
/institutionsResponse contract
InstitutionSummary[]200 OK
GET/datasets/metricsRead the accepted dataset total
Catalogue metrics
/datasets/metricsRead the accepted dataset total
Request parameters
None.
Example path
/datasets/metricsResponse contract
{ total: number }200 OK
titleSearch dataset titles
categoryIdRestrict results to a category
institutionIdRestrict results to a publisher
tagsMatch one or more dataset tags
page / limitControl result pagination
sortBy / sortOrderControl result ordering
Publishing requires an approved account.
Dataset submission, review, and administration use bearer-token authentication and role checks. Those private operations are intentionally omitted from this public reference.
Ask about publishing access