University of Geneva

Yareta Ingest API

The pre-ingest/ingest module of Yareta: deposit, validate and submit research data, reserve a DOI, and submit a SIP for archiving. Runs on UNIGE's own host ingest.yareta.unige.ch. Fully bearer-gated — no anonymous operation was reachable on 2026-09-01, and the origin contract at /v3/api-docs returned 401. DOIs minted here resolve under prefix 10.26037, delegated to the DataCite repository account ethz.genfyareta ("Uni Genf: Yareta").

GitHub OpenAPI

Operations 139

GET /preingest/deposits Preingest deposits list #
POST /preingest/deposits Preingest deposits create #
DELETE /preingest/deposits Preingest deposits delete list #
GET /preingest/deposits/{parentid}/submission-agreements Preingest deposits by id submission agreements list #
POST /preingest/deposits/{parentid}/submission-agreements Preingest deposits by id submission agreements create #
DELETE /preingest/deposits/{parentid}/submission-agreements Preingest deposits by id submission agreements delete list #
GET /preingest/deposits/{parentid}/subject-areas Preingest deposits by id subject areas list #
POST /preingest/deposits/{parentid}/subject-areas Preingest deposits by id subject areas create #
DELETE /preingest/deposits/{parentid}/subject-areas Preingest deposits by id subject areas delete list #
GET /preingest/deposits/{parentid}/licenses Preingest deposits by id licenses list #
POST /preingest/deposits/{parentid}/licenses Preingest deposits by id licenses create #
DELETE /preingest/deposits/{parentid}/licenses Preingest deposits by id licenses delete list #
GET /preingest/deposits/{parentid}/data Preingest deposits by id data list #
POST /preingest/deposits/{parentid}/data Preingest deposits by id data create #
DELETE /preingest/deposits/{parentid}/data Preingest deposits by id data delete list #
POST /preingest/deposits/{parentid}/data/{id}/validate Preingest deposits by id data by id validate #
POST /preingest/deposits/{parentid}/data/{id}/resume Preingest deposits by id data by id resume #
POST /preingest/deposits/{parentid}/data/validate Preingest deposits by id data validate #
POST /preingest/deposits/{parentid}/data/resume Preingest deposits by id data resume #
POST /preingest/deposits/{parentid}/data/resume-all Preingest deposits by id data resume all resume list #
POST /preingest/deposits/{parentid}/data/delete-folder Preingest deposits by id data delete folder #
GET /preingest/deposits/{parentid}/contributors Preingest deposits by id contributors list #
POST /preingest/deposits/{parentid}/contributors Preingest deposits by id contributors create #
DELETE /preingest/deposits/{parentid}/contributors Preingest deposits by id contributors delete list #
GET /preingest/deposits/{parentid}/aip Preingest deposits by id aip list #
POST /preingest/deposits/{parentid}/aip Preingest deposits by id aip create #
DELETE /preingest/deposits/{parentid}/aip Preingest deposits by id aip delete list #
POST /preingest/deposits/{id}/upload Preingest deposits by id upload #
POST /preingest/deposits/{id}/upload-metadata Preingest deposits by id upload metadata #
POST /preingest/deposits/{id}/upload-archive Preingest deposits by id upload archive #
POST /preingest/deposits/{id}/submit-for-approval Preingest deposits by id submit for approval #
POST /preingest/deposits/{id}/start-metadata-upgrade Preingest deposits by id start metadata upgrade put in metadata upgrading #
POST /preingest/deposits/{id}/start-metadata-editing Preingest deposits by id start metadata editing put in metadata editing #
POST /preingest/deposits/{id}/reserve-doi Preingest deposits by id reserve doi #
POST /preingest/deposits/{id}/reject Preingest deposits by id reject #
POST /preingest/deposits/{id}/put-in-error Preingest deposits by id put in error #
POST /preingest/deposits/{id}/generate-anonymized-deposit-page Preingest deposits by id generate anonymized deposit page #
POST /preingest/deposits/{id}/enable-revision Preingest deposits by id enable revision #
POST /preingest/deposits/{id}/clean Preingest deposits by id clean #
POST /preingest/deposits/{id}/check-submission-agreement Preingest deposits by id check submission agreement #
POST /preingest/deposits/{id}/check-compliance Preingest deposits by id check compliance #
POST /preingest/deposits/{id}/cancel-metadata-editing Preingest deposits by id cancel metadata editing #
POST /preingest/deposits/{id}/approve Preingest deposits by id approve #
POST /preingest/deposits/{id}/approve-submission-agreement Preingest deposits by id approve submission agreement #
GET /preingest/deposits/search Preingest deposits search advanced search get #
POST /preingest/deposits/search Preingest deposits search advanced search post #
GET /ingest/sip Ingest sip list #
POST /ingest/sip Ingest sip create #
DELETE /ingest/sip Ingest sip delete list #
GET /ingest/sip/{parentid}/data Ingest sip by id data list #
POST /ingest/sip/{parentid}/data Ingest sip by id data create #
DELETE /ingest/sip/{parentid}/data Ingest sip by id data delete list #
POST /ingest/sip/{parentid}/data/{id}/resume Ingest sip by id data by id resume #
POST /ingest/sip/{parentid}/data/{id}/put-in-error Ingest sip by id data by id put in error #
GET /ingest/sip/{parentid}/aip Ingest sip by id aip list #
POST /ingest/sip/{parentid}/aip Ingest sip by id aip create #
DELETE /ingest/sip/{parentid}/aip Ingest sip by id aip delete list #
POST /ingest/sip/{id}/upload Ingest sip by id upload send file #
POST /ingest/sip/{id}/start-metadata-upgrade Ingest sip by id start metadata upgrade put in metadata upgrading #
POST /ingest/sip/{id}/start-metadata-editing Ingest sip by id start metadata editing put in metadata editing #
POST /ingest/sip/{id}/resume Ingest sip by id resume #
POST /ingest/sip/{id}/resubmit Ingest sip by id resubmit #
POST /ingest/sip/{id}/put-in-error Ingest sip by id put in error #
POST /ingest/sip/{id}/clean Ingest sip by id clean #
GET /ingest/sip/search Ingest sip search advanced search get #
POST /ingest/sip/search Ingest sip search advanced search post #
GET /preingest/deposits/{parentid}/submission-agreements/{id} Preingest deposits by id submission agreements by id get #
DELETE /preingest/deposits/{parentid}/submission-agreements/{id} Preingest deposits by id submission agreements by id delete #
PATCH /preingest/deposits/{parentid}/submission-agreements/{id} Preingest deposits by id submission agreements by id update #
GET /preingest/deposits/{parentid}/subject-areas/{id} Preingest deposits by id subject areas by id get #
DELETE /preingest/deposits/{parentid}/subject-areas/{id} Preingest deposits by id subject areas by id delete #
PATCH /preingest/deposits/{parentid}/subject-areas/{id} Preingest deposits by id subject areas by id update #
GET /preingest/deposits/{parentid}/licenses/{id} Preingest deposits by id licenses by id get #
DELETE /preingest/deposits/{parentid}/licenses/{id} Preingest deposits by id licenses by id delete #
PATCH /preingest/deposits/{parentid}/licenses/{id} Preingest deposits by id licenses by id update #
GET /preingest/deposits/{parentid}/data/{id} Preingest deposits by id data by id get #
DELETE /preingest/deposits/{parentid}/data/{id} Preingest deposits by id data by id delete #
PATCH /preingest/deposits/{parentid}/data/{id} Preingest deposits by id data by id update #
GET /preingest/deposits/{parentid}/contributors/{id} Preingest deposits by id contributors by id get #
DELETE /preingest/deposits/{parentid}/contributors/{id} Preingest deposits by id contributors by id delete #
PATCH /preingest/deposits/{parentid}/contributors/{id} Preingest deposits by id contributors by id update #
GET /preingest/deposits/{parentid}/aip/{id} Preingest deposits by id aip by id get #
DELETE /preingest/deposits/{parentid}/aip/{id} Preingest deposits by id aip by id delete #
PATCH /preingest/deposits/{parentid}/aip/{id} Preingest deposits by id aip by id update #
GET /preingest/deposits/{id} Preingest deposits by id get #
DELETE /preingest/deposits/{id} Preingest deposits by id delete #
PATCH /preingest/deposits/{id} Preingest deposits by id update #
GET /ingest/sip/{parentid}/data/{id} Ingest sip by id data by id get #
DELETE /ingest/sip/{parentid}/data/{id} Ingest sip by id data by id delete #
PATCH /ingest/sip/{parentid}/data/{id} Ingest sip by id data by id update #
GET /ingest/sip/{parentid}/aip/{id} Ingest sip by id aip by id get #
DELETE /ingest/sip/{parentid}/aip/{id} Ingest sip by id aip by id delete #
PATCH /ingest/sip/{parentid}/aip/{id} Ingest sip by id aip by id update #
GET /ingest/sip/{id} Ingest sip by id get #
DELETE /ingest/sip/{id} Ingest sip by id delete #
PATCH /ingest/sip/{id} Ingest sip by id update #
GET /preingest Preingest home #
GET /preingest/deposits/{parentid}/data/{id}/history Preingest deposits by id data by id history #
GET /preingest/deposits/{parentid}/data/{id}/download Preingest deposits by id data by id download #
GET /preingest/deposits/{parentid}/data/{id}/download-token Preingest deposits by id data by id download token get token for deposit data… #
GET /preingest/deposits/{parentid}/data/search Preingest deposits by id data search get #
GET /preingest/deposits/{parentid}/data/list-status Preingest deposits by id data list status #
GET /preingest/deposits/{parentid}/data/list-folders Preingest deposits by id data list folders #
GET /preingest/deposits/{parentid}/data/list-current-status Preingest deposits by id data list current status #
GET /preingest/deposits/{id}/sip-package Preingest deposits by id sip package get SIP #
DELETE /preingest/deposits/{id}/sip-package Preingest deposits by id sip package delete SIP #
GET /preingest/deposits/{id}/history Preingest deposits by id history #
GET /preingest/deposits/{id}/download Preingest deposits by id download get files #
GET /preingest/deposits/{id}/download-token Preingest deposits by id download token get token for deposit #
GET /preingest/deposits/{id}/download-anonymized-deposit Preingest deposits by id download anonymized deposit #
GET /preingest/deposits/schema Preingest deposits schema #
GET /preingest/deposits/profile Download profile of a package #
GET /preingest/deposits/list-status Preingest deposits list status #
GET /preingest/deposits/list-metadata-versions Preingest deposits list metadata versions #
GET /preingest/deposits/list-ignore-files Preingest deposits list ignore files ignore list #
GET /preingest/deposits/list-exclude-files Preingest deposits list exclude files exclude list #
GET /preingest/deposits/list-data-types Preingest deposits list data types #
GET /preingest/deposits/list-data-categories Preingest deposits list data categories #
GET /preingest/deposits/list-accesses Preingest deposits list accesses #
GET /preingest/contributors Preingest contributors list #
GET /preingest/contributors/{parentid}/deposits Preingest contributors by id deposits list #
GET /preingest/contributors/{parentid}/deposits/{id} Preingest contributors by id deposits by id get #
GET /preingest/contributors/{id} Preingest contributors by id get #
GET /ingest Ingest home #
GET /ingest/sip/{parentid}/data/{id}/history Ingest sip by id data by id history #
GET /ingest/sip/{parentid}/data/{id}/download Ingest sip by id data by id download #
GET /ingest/sip/{parentid}/data/{id}/download-token Ingest sip by id data by id download token get token for sip data file #
GET /ingest/sip/{parentid}/data/list-status Ingest sip by id data list status #
GET /ingest/sip/{id}/history Ingest sip by id history #
GET /ingest/sip/{id}/download Ingest sip by id download get files #
GET /ingest/sip/{id}/download-token Ingest sip by id download token get token for sip #
GET /ingest/sip/{id}/aip-package Ingest sip by id aip package get AIP #
DELETE /ingest/sip/{id}/aip-package Ingest sip by id aip package delete AIP #
GET /ingest/sip/schema Download schema of a SIP #
GET /ingest/sip/profile Download profile of a package #
GET /ingest/sip/list-status Ingest sip list status #
GET /ingest/sip/list-metadata-versions Ingest sip list metadata versions #
GET /ingest/sip/list-data-types Ingest sip list data types #
GET /ingest/sip/list-data-categories Ingest sip list data categories #

Documentation

📖
Documentation
https://www.unige.ch/eresearch/en/services/yareta/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/authentication/university-of-geneva-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/openapi/university-of-geneva-ingest-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/json-schema/university-of-geneva-aip-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/json-schema/university-of-geneva-order-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/json-structure/university-of-geneva-aip-structure.json

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/errors/university-of-geneva-errors.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/lifecycle/university-of-geneva-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/conformance/university-of-geneva-conformance.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/examples/university-of-geneva-order-create-request-example.json
🔗
Rules
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/rules/university-of-geneva-rules.yml
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/vocabulary/university-of-geneva-vocabulary.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/json-ld/university-of-geneva-context.jsonld
🔗
Postman
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/collections/university-of-geneva-ingest-api.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/collections/university-of-geneva-ingest-api.opencollection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/university-of-geneva-ingest-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

university-of-geneva-ingest-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Yareta Research Data Ingest API
  description: Yareta is the University of Geneva (UNIGE) e-Research long-term research-data preservation and access platform, built on the DLCM (Data Life Cycle Management) software stack.
  version: 3.1.7
  contact:
    email: yareta-admin@unige.ch
  x-provenance:
    method: derived
    source: https://access.yareta.unige.ch/v3/api-docs
    derived: '2026-06-03'
    verified: '2026-09-01'
    note: Converted by API Evangelist from the Yareta (DLCM/Solidify) springdoc OpenAPI 3.1 documents published by the UNIGE eResearch access and ingest modules. Not published by the University of Geneva as an artifact. The live /v3/api-docs endpoints on both access.yareta.unige.ch and ingest.yareta.unige.ch returned HTTP 401 on 2026-09-01, so this copy cannot currently be re-verified against source.
    x-operator: institution
servers:
- url: https://access.yareta.unige.ch
  description: Accession / Access module (discovery, orders, DIP download)
- url: https://ingest.yareta.unige.ch
  description: Pre-ingest / Ingestion module (deposits, submission)
tags:


# --- truncated at 32 KB (215 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/university-of-geneva/refs/heads/main/openapi/university-of-geneva-ingest-api-openapi.yml