# University of Helsinki Documents API

**Canonical:** https://apis.io/apis/university-of-helsinki/university-of-helsinki-documents-api/  
**Provider:** University of Helsinki — https://apis.io/providers/university-of-helsinki/  
**Base URL:** https://api.helsinki.fi/portal/environments/DEFAULT  
**Documentation:** https://api.helsinki.fi/portal/

University of Helsinki Documents API is one of 93 APIs that [University of Helsinki](https://apis.io/providers/university-of-helsinki/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 11 JSON Schema definitions. Tagged areas include Documents. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and 11 JSON Schemas.

The Documents API from University of Helsinki — 7 operation(s) for documents.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| POST | `/documents/batch` | Starts a batch job that validates the documents. |
| GET | `/documents/batch/{jobID}` | Get a batch job's status. |
| POST | `/documents/batch/{jobID}` | Completes a given batch job by sending them to the store/warehouse. |
| POST | `/documents/validate` | Validate a document |
| GET | `/documents/count/byYear` | Get count of documents by type (currently just "byYear") |
| GET | `/documents/stats` | Get the median date of documents for a named place |
| GET | `/documents` | Get a page of documents |
| POST | `/documents` | Create a new document |
| GET | `/documents/{id}` | Get a document |
| PUT | `/documents/{id}` | Update an existing document |
| DELETE | `/documents/{id}` | Delete a document |

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/openapi/university-of-helsinki-documents-api-openapi.yml
- **DeveloperPortal** — https://api.helsinki.fi/portal/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-hy-organisation-api-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-contact-search-api-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-course-pages-cms-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-helsinki-fi-content-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-hy-building-api-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-serviceapi-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-employeeinformationapi-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-persongroup-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-general-efecte-api-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-network-registry-api-schemas.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-finbif-laji-schemas.json
- **APIReference** — https://api.laji.fi/openapi
- **Documentation** — https://info.laji.fi/en/

## Other University of Helsinki APIs (12)

- [University of Helsinki API Portal (Gravitee)](https://apis.io/apis/university-of-helsinki/api-gateway/)
- [Dependency Track](https://apis.io/apis/university-of-helsinki/dependency-track/)
- [Flamma Liferay Headless API](https://apis.io/apis/university-of-helsinki/flamma-liferay-headless/)
- [Internal Guide CMS JSON-API](https://apis.io/apis/university-of-helsinki/internal-guide-cms/)
- [Helda DSpace REST API](https://apis.io/apis/university-of-helsinki/helda-rest/)
- [Helda OAI-PMH Metadata Interface](https://apis.io/apis/university-of-helsinki/helda-oai/)
- [HY Data Catalogue DSpace REST API](https://apis.io/apis/university-of-helsinki/datakatalogi-rest/)
- [HY Data Catalogue OAI-PMH Interface](https://apis.io/apis/university-of-helsinki/datakatalogi-oai/)
- [Editori (journals.helsinki.fi) OAI-PMH Interface](https://apis.io/apis/university-of-helsinki/editori-oai/)
- [HY Login Service — Shibboleth IdP + OpenID Connect](https://apis.io/apis/university-of-helsinki/identity-provider/)
- [Sisu (Kori) Student Information System — University of Helsinki tenant](https://apis.io/apis/university-of-helsinki/sisu-kori/)
- [University of Helsinki Research Portal — Elsevier Pure tenant](https://apis.io/apis/university-of-helsinki/research-portal/)

## Tags

Documents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/university-of-helsinki/university-of-helsinki-documents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/university-of-helsinki/.