# Universiti Sains Malaysia Repository API

**Canonical:** https://apis.io/apis/usm/usm-repository-api/  
**Provider:** Universiti Sains Malaysia — https://apis.io/providers/usm/  
**Base URL:** https://eprints.usm.my/cgi/oai2  
**Documentation:** https://eprints.usm.my/

Universiti Sains Malaysia Repository API is one of 7 APIs that [Universiti Sains Malaysia](https://apis.io/providers/usm/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Repository. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, API documentation, and 1 JSON Schema.

EPrints REST dataset and record access.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/rest/` | List the REST datasets exposed by the repository |
| GET | `/rest/eprint/` | List every eprint id in the repository |
| GET | `/rest/eprint/{eprintid}.xml` | Get one record as EPrints EP2 data XML |
| GET | `/rest/eprint/{eprintid}/documents.xml` | Get the document (file) set attached to a record |
| GET | `/rest/eprint/{eprintid}/{field}.txt` | Get a single metadata field as plain text |
| GET | `/rest/subject/{subjectid}.xml` | Get one subject-classification node as EP2 XML |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/usm/refs/heads/main/openapi/usm-repository-api-openapi.yml
- **Errors** — https://raw.githubusercontent.com/api-evangelist/usm/refs/heads/main/errors/usm-repository-oai-pmh-errors.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/usm/refs/heads/main/examples/usm-repository-examples.yml
- **Vocabulary** — https://raw.githubusercontent.com/api-evangelist/usm/refs/heads/main/vocabulary/usm-repository-vocabulary.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/usm/refs/heads/main/lifecycle/usm-repository-lifecycle.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/usm/refs/heads/main/authentication/usm-authentication.yml
- **Documentation** — https://eprints.usm.my/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usm/refs/heads/main/json-schema/usm-eprint-record.json
- **Documentation** — https://eprints.usm.my/rest/

## Other Universiti Sains Malaysia APIs (6)

- [USM Shibboleth Identity Provider (SIFULAN / eduGAIN)](https://apis.io/apis/usm/shibboleth-idp/)
- [e-Learning@USM Moodle Web Services](https://apis.io/apis/usm/moodle-ws/)
- [Crossref membership — Universiti Sains Malaysia](https://apis.io/apis/usm/crossref-member/)
- [ROR record — Universiti Sains Malaysia](https://apis.io/apis/usm/ror-record/)
- [Universiti Sains Malaysia Export API](https://apis.io/apis/usm/usm-export-api/)
- [Universiti Sains Malaysia OAI PMH API](https://apis.io/apis/usm/usm-oai-pmh-api/)

## Tags

Repository

---

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