# USM Repository EPrints REST and Export

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

USM Repository EPrints REST and Export is one of 6 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, REST, Research, Open Access, and Metadata. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, API documentation, and 1 JSON Schema.

Anonymous read interface to Repository@USM beyond OAI-PMH, verified route by route on 2026-09-01. /rest/ exposes three datasets (eprint, user, subject); /rest/eprint/{id}.xml returns full EPrints EP2 data XML; /rest/eprint/{id}/{field}.txt gives single-field plain-text access; /rest/subject/{id}.xml walks the Library of Congress subject tree; and /cgi/export/eprint/{id}/{format}/{filename} serves seventeen verified bibliographic serializations including JSON, RDF/XML, METS, MODS, DIDL, Atom, BibTeX and RIS. One soft-404 trap is documented in the contract: /rest/eprint/{id}.json answers HTTP 200 with the repository's HTML landing page, not JSON.

## Operations (7)

| 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 |
| GET | `/cgi/export/eprint/{eprintid}/{format}/{filename}` | Export one record in a named bibliographic format |

## Machine-readable artifacts (6)

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

## Other Universiti Sains Malaysia APIs (5)

- [USM Repository OAI-PMH](https://apis.io/apis/usm/eprints-oai/)
- [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/)

## Tags

Repository, REST, Research, Open Access, Metadata, EPrints, Bibliographic

---

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