How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

University of Geneva Ingest API

Deposit, validate and submit research data.

University of Geneva Ingest API is one of 5 APIs that University of Geneva publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 7 JSON Schema definitions.

Tagged areas include Ingest. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 7 JSON Schemas.

This API exposes 139 operations across 95 paths, and defines 60 schemas. It is described by OpenAPI 3.0.3, at version 3.1.7.

Requests are made against 2 base URLs: https://access.yareta.unige.ch, https://ingest.yareta.unige.ch.

139 operations 95 paths 60 schemas 22 DELETE63 GET10 PATCH44 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
3.1.7
Base URL
https://archive-ouverte.unige.ch/oai
Resource Areas
1

Paths & Operations 139

Across 95 paths, the API surfaces 139 operations — 22 DELETE, 63 GET, 10 PATCH, 44 POST. Each is listed below with its method, path, parameters, and response codes.

Ingest 139

Deposit, validate and submit research data.

GET
/preingest/deposits
preingest_deposits_list 32 params → 200
POST
/preingest/deposits
preingest_deposits_create body → 200
DELETE
/preingest/deposits
preingest_deposits_deleteList body → 200
GET
/preingest/deposits/{parentid}/submission-agreements
preingest_deposits_by_id_submission-agreements_list 4 params → 200
POST
/preingest/deposits/{parentid}/submission-agreements
preingest_deposits_by_id_submission-agreements_create 1 param body → 200
DELETE
/preingest/deposits/{parentid}/submission-agreements
preingest_deposits_by_id_submission-agreements_deleteList 1 param body → 200
GET
/preingest/deposits/{parentid}/subject-areas
preingest_deposits_by_id_subject-areas_list 4 params → 200
POST
/preingest/deposits/{parentid}/subject-areas
preingest_deposits_by_id_subject-areas_create 1 param body → 200
DELETE
/preingest/deposits/{parentid}/subject-areas
preingest_deposits_by_id_subject-areas_deleteList 1 param body → 200
GET
/preingest/deposits/{parentid}/licenses
preingest_deposits_by_id_licenses_list 4 params → 200
POST
/preingest/deposits/{parentid}/licenses
preingest_deposits_by_id_licenses_create 1 param body → 200
DELETE
/preingest/deposits/{parentid}/licenses
preingest_deposits_by_id_licenses_deleteList 1 param → 200
GET
/preingest/deposits/{parentid}/data
preingest_deposits_by_id_data_list 15 params → 200
POST
/preingest/deposits/{parentid}/data
preingest_deposits_by_id_data_create 1 param body → 200
DELETE
/preingest/deposits/{parentid}/data
preingest_deposits_by_id_data_deleteList 1 param body → 200
POST
/preingest/deposits/{parentid}/data/{id}/validate
preingest_deposits_by_id_data_by_id_validate 2 params → 200
POST
/preingest/deposits/{parentid}/data/{id}/resume
preingest_deposits_by_id_data_by_id_resume 2 params → 200
POST
/preingest/deposits/{parentid}/data/validate
preingest_deposits_by_id_data_validate 1 param body → 200
POST
/preingest/deposits/{parentid}/data/resume
preingest_deposits_by_id_data_resume 1 param body → 200
POST
/preingest/deposits/{parentid}/data/resume-all
preingest_deposits_by_id_data_resume-all_resumeList 1 param → 200
POST
/preingest/deposits/{parentid}/data/delete-folder
preingest_deposits_by_id_data_delete-folder 2 params → 200
GET
/preingest/deposits/{parentid}/contributors
preingest_deposits_by_id_contributors_list 4 params → 200
POST
/preingest/deposits/{parentid}/contributors
preingest_deposits_by_id_contributors_create 1 param body → 200
DELETE
/preingest/deposits/{parentid}/contributors
preingest_deposits_by_id_contributors_deleteList 1 param body → 200
GET
/preingest/deposits/{parentid}/aip
preingest_deposits_by_id_aip_list 4 params → 200
POST
/preingest/deposits/{parentid}/aip
preingest_deposits_by_id_aip_create 1 param body → 200
DELETE
/preingest/deposits/{parentid}/aip
preingest_deposits_by_id_aip_deleteList 1 param → 200
POST
/preingest/deposits/{id}/upload
preingest_deposits_by_id_upload 15 params body → 200
POST
/preingest/deposits/{id}/upload-metadata
preingest_deposits_by_id_upload-metadata 1 param body → 200
POST
/preingest/deposits/{id}/upload-archive
preingest_deposits_by_id_upload-archive 4 params body → 200
POST
/preingest/deposits/{id}/submit-for-approval
preingest_deposits_by_id_submit-for-approval 1 param → 200
POST
/preingest/deposits/{id}/start-metadata-upgrade
preingest_deposits_by_id_start-metadata-upgrade_putInMetadataUpgrading 1 param → 200
POST
/preingest/deposits/{id}/start-metadata-editing
preingest_deposits_by_id_start-metadata-editing_putInMetadataEditing 1 param → 200
POST
/preingest/deposits/{id}/reserve-doi
preingest_deposits_by_id_reserve-doi 1 param → 200
POST
/preingest/deposits/{id}/reject
preingest_deposits_by_id_reject 2 params → 200
POST
/preingest/deposits/{id}/put-in-error
preingest_deposits_by_id_put-in-error 1 param → 200
POST
/preingest/deposits/{id}/generate-anonymized-deposit-page
preingest_deposits_by_id_generate-anonymized-deposit-page 1 param → 200
POST
/preingest/deposits/{id}/enable-revision
preingest_deposits_by_id_enable-revision 1 param → 200
POST
/preingest/deposits/{id}/clean
preingest_deposits_by_id_clean 1 param → 200
POST
/preingest/deposits/{id}/check-submission-agreement
preingest_deposits_by_id_check-submission-agreement 1 param → 200
POST
/preingest/deposits/{id}/check-compliance
preingest_deposits_by_id_check-compliance 1 param → 200
POST
/preingest/deposits/{id}/cancel-metadata-editing
preingest_deposits_by_id_cancel-metadata-editing 1 param → 200
POST
/preingest/deposits/{id}/approve
preingest_deposits_by_id_approve 1 param → 200
POST
/preingest/deposits/{id}/approve-submission-agreement
preingest_deposits_by_id_approve-submission-agreement 1 param → 200
GET
/preingest/deposits/search
preingest_deposits_search_advancedSearch_get 33 params → 200
POST
/preingest/deposits/search
preingest_deposits_search_advancedSearch_post 4 params body → 200
GET
/ingest/sip
ingest_sip_list 11 params → 200
POST
/ingest/sip
ingest_sip_create body → 200
DELETE
/ingest/sip
ingest_sip_deleteList body → 200
GET
/ingest/sip/{parentid}/data
ingest_sip_by_id_data_list 15 params → 200
POST
/ingest/sip/{parentid}/data
ingest_sip_by_id_data_create 1 param body → 200
DELETE
/ingest/sip/{parentid}/data
ingest_sip_by_id_data_deleteList 1 param body → 200
POST
/ingest/sip/{parentid}/data/{id}/resume
ingest_sip_by_id_data_by_id_resume 2 params → 200
POST
/ingest/sip/{parentid}/data/{id}/put-in-error
ingest_sip_by_id_data_by_id_put-in-error 2 params → 200
GET
/ingest/sip/{parentid}/aip
ingest_sip_by_id_aip_list 4 params → 200
POST
/ingest/sip/{parentid}/aip
ingest_sip_by_id_aip_create 1 param body → 200
DELETE
/ingest/sip/{parentid}/aip
ingest_sip_by_id_aip_deleteList 1 param body → 200
POST
/ingest/sip/{id}/upload
ingest_sip_by_id_upload_sendFile 1 param body → 200
POST
/ingest/sip/{id}/start-metadata-upgrade
ingest_sip_by_id_start-metadata-upgrade_putInMetadataUpgrading 1 param → 200
POST
/ingest/sip/{id}/start-metadata-editing
ingest_sip_by_id_start-metadata-editing_putInMetadataEditing 1 param → 200
POST
/ingest/sip/{id}/resume
ingest_sip_by_id_resume 1 param → 200
POST
/ingest/sip/{id}/resubmit
ingest_sip_by_id_resubmit 1 param → 200
POST
/ingest/sip/{id}/put-in-error
ingest_sip_by_id_put-in-error 1 param → 200
POST
/ingest/sip/{id}/clean
ingest_sip_by_id_clean 1 param → 200
GET
/ingest/sip/search
ingest_sip_search_advancedSearch_get 5 params → 200
POST
/ingest/sip/search
ingest_sip_search_advancedSearch_post 4 params body → 200
GET
/preingest/deposits/{parentid}/submission-agreements/{id}
preingest_deposits_by_id_submission-agreements_by_id_get 2 params → 200
DELETE
/preingest/deposits/{parentid}/submission-agreements/{id}
preingest_deposits_by_id_submission-agreements_by_id_delete 2 params → 200
PATCH
/preingest/deposits/{parentid}/submission-agreements/{id}
preingest_deposits_by_id_submission-agreements_by_id_update 2 params body → 200
GET
/preingest/deposits/{parentid}/subject-areas/{id}
preingest_deposits_by_id_subject-areas_by_id_get 2 params → 200
DELETE
/preingest/deposits/{parentid}/subject-areas/{id}
preingest_deposits_by_id_subject-areas_by_id_delete 2 params → 200
PATCH
/preingest/deposits/{parentid}/subject-areas/{id}
preingest_deposits_by_id_subject-areas_by_id_update 2 params body → 200
GET
/preingest/deposits/{parentid}/licenses/{id}
preingest_deposits_by_id_licenses_by_id_get 2 params → 200
DELETE
/preingest/deposits/{parentid}/licenses/{id}
preingest_deposits_by_id_licenses_by_id_delete 2 params → 200
PATCH
/preingest/deposits/{parentid}/licenses/{id}
preingest_deposits_by_id_licenses_by_id_update 2 params body → 200
GET
/preingest/deposits/{parentid}/data/{id}
preingest_deposits_by_id_data_by_id_get 2 params → 200
DELETE
/preingest/deposits/{parentid}/data/{id}
preingest_deposits_by_id_data_by_id_delete 2 params → 200
PATCH
/preingest/deposits/{parentid}/data/{id}
preingest_deposits_by_id_data_by_id_update 2 params body → 200
GET
/preingest/deposits/{parentid}/contributors/{id}
preingest_deposits_by_id_contributors_by_id_get 2 params → 200
DELETE
/preingest/deposits/{parentid}/contributors/{id}
preingest_deposits_by_id_contributors_by_id_delete 2 params → 200
PATCH
/preingest/deposits/{parentid}/contributors/{id}
preingest_deposits_by_id_contributors_by_id_update 2 params body → 200
GET
/preingest/deposits/{parentid}/aip/{id}
preingest_deposits_by_id_aip_by_id_get 2 params → 200
DELETE
/preingest/deposits/{parentid}/aip/{id}
preingest_deposits_by_id_aip_by_id_delete 2 params → 200
PATCH
/preingest/deposits/{parentid}/aip/{id}
preingest_deposits_by_id_aip_by_id_update 2 params body → 200
GET
/preingest/deposits/{id}
preingest_deposits_by_id_get 1 param → 200
DELETE
/preingest/deposits/{id}
preingest_deposits_by_id_delete 1 param → 200
PATCH
/preingest/deposits/{id}
preingest_deposits_by_id_update 1 param body → 200
GET
/ingest/sip/{parentid}/data/{id}
ingest_sip_by_id_data_by_id_get 2 params → 200
DELETE
/ingest/sip/{parentid}/data/{id}
ingest_sip_by_id_data_by_id_delete 2 params → 200
PATCH
/ingest/sip/{parentid}/data/{id}
ingest_sip_by_id_data_by_id_update 2 params body → 200
GET
/ingest/sip/{parentid}/aip/{id}
ingest_sip_by_id_aip_by_id_get 2 params → 200
DELETE
/ingest/sip/{parentid}/aip/{id}
ingest_sip_by_id_aip_by_id_delete 2 params → 200
PATCH
/ingest/sip/{parentid}/aip/{id}
ingest_sip_by_id_aip_by_id_update 2 params body → 200
GET
/ingest/sip/{id}
ingest_sip_by_id_get 1 param → 200
DELETE
/ingest/sip/{id}
ingest_sip_by_id_delete 1 param → 200
PATCH
/ingest/sip/{id}
ingest_sip_by_id_update 1 param body → 200
GET
/preingest
preingest_home → 200
GET
/preingest/deposits/{parentid}/data/{id}/history
preingest_deposits_by_id_data_by_id_history 3 params → 200
GET
/preingest/deposits/{parentid}/data/{id}/download
preingest_deposits_by_id_data_by_id_download 2 params → 200
GET
/preingest/deposits/{parentid}/data/{id}/download-token
preingest_deposits_by_id_data_by_id_download-token_getTokenForDepositDataFile 2 params → 200
GET
/preingest/deposits/{parentid}/data/search
preingest_deposits_by_id_data_search_get 17 params → 200
GET
/preingest/deposits/{parentid}/data/list-status
preingest_deposits_by_id_data_list-status 1 param → 200
GET
/preingest/deposits/{parentid}/data/list-folders
preingest_deposits_by_id_data_list-folders 1 param → 200
GET
/preingest/deposits/{parentid}/data/list-current-status
preingest_deposits_by_id_data_list-current-status 12 params → 200
GET
/preingest/deposits/{id}/sip-package
preingest_deposits_by_id_sip-package_getSIP 1 param → 200
DELETE
/preingest/deposits/{id}/sip-package
preingest_deposits_by_id_sip-package_deleteSIP 1 param → 200
GET
/preingest/deposits/{id}/history
preingest_deposits_by_id_history 2 params → 200
GET
/preingest/deposits/{id}/download
preingest_deposits_by_id_download_getFiles 2 params → 200
GET
/preingest/deposits/{id}/download-token
preingest_deposits_by_id_download-token_getTokenForDeposit 1 param → 200
GET
/preingest/deposits/{id}/download-anonymized-deposit
preingest_deposits_by_id_download-anonymized-deposit 1 param → 200
GET
/preingest/deposits/schema
preingest_deposits_schema 1 param → 200
GET
/preingest/deposits/profile
Download profile of a package
preingest_deposits_profile 1 param → 200404
GET
/preingest/deposits/list-status
preingest_deposits_list-status → 200
GET
/preingest/deposits/list-metadata-versions
preingest_deposits_list-metadata-versions → 200
GET
/preingest/deposits/list-ignore-files
preingest_deposits_list-ignore-files_ignoreList → 200
GET
/preingest/deposits/list-exclude-files
preingest_deposits_list-exclude-files_excludeList → 200
GET
/preingest/deposits/list-data-types
preingest_deposits_list-data-types 1 param → 200
GET
/preingest/deposits/list-data-categories
preingest_deposits_list-data-categories → 200
GET
/preingest/deposits/list-accesses
preingest_deposits_list-accesses → 200
GET
/preingest/contributors
preingest_contributors_list 3 params → 200
GET
/preingest/contributors/{parentid}/deposits
preingest_contributors_by_id_deposits_list 5 params → 200
GET
/preingest/contributors/{parentid}/deposits/{id}
preingest_contributors_by_id_deposits_by_id_get 2 params → 200
GET
/preingest/contributors/{id}
preingest_contributors_by_id_get 1 param → 200
GET
/ingest
ingest_home → 200
GET
/ingest/sip/{parentid}/data/{id}/history
ingest_sip_by_id_data_by_id_history 3 params → 200
GET
/ingest/sip/{parentid}/data/{id}/download
ingest_sip_by_id_data_by_id_download 2 params → 200
GET
/ingest/sip/{parentid}/data/{id}/download-token
ingest_sip_by_id_data_by_id_download-token_getTokenForSipDataFile 2 params → 200
GET
/ingest/sip/{parentid}/data/list-status
ingest_sip_by_id_data_list-status 1 param → 200
GET
/ingest/sip/{id}/history
ingest_sip_by_id_history 2 params → 200
GET
/ingest/sip/{id}/download
ingest_sip_by_id_download_getFiles 1 param → 200
GET
/ingest/sip/{id}/download-token
ingest_sip_by_id_download-token_getTokenForSip 1 param → 200
GET
/ingest/sip/{id}/aip-package
ingest_sip_by_id_aip-package_getAIP 1 param → 200
DELETE
/ingest/sip/{id}/aip-package
ingest_sip_by_id_aip-package_deleteAIP 1 param → 200
GET
/ingest/sip/schema
Download schema of a SIP
ingest_sip_schema 1 param → 200404
GET
/ingest/sip/profile
Download profile of a package
ingest_sip_profile 1 param → 200404
GET
/ingest/sip/list-status
ingest_sip_list-status → 200
GET
/ingest/sip/list-metadata-versions
ingest_sip_list-metadata-versions → 200
GET
/ingest/sip/list-data-types
ingest_sip_list-data-types 1 param → 200
GET
/ingest/sip/list-data-categories
ingest_sip_list-data-categories → 200

Schemas 60

The contract defines 60 schemas that model the data the API accepts and returns. The most detailed are Deposit (46 properties), ArchivalInfoPackage (33 properties), DepositDataFile (24 properties), SipDataFile (24 properties). Each schema is shown below with its type and property counts.

SubmissionInfoPackage
object
Submission Information Package (SIP)
20 properties
LicenseLogo
object
7 properties
SubmissionAgreement
object
A submission agreement defines the conditions of the submissions.
8 properties
Module
object
The functional module.
2 properties
RestCollectionSubmissionAgreement
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
MetadataType
object
The metadata type allow to define custom metadata.
11 properties
SubmissionAgreementFile
object
7 properties
ChangeInfo
object
The change information of an action.
3 properties
OrganizationalUnitLogo
object
7 properties
EmbargoInfo
object
Embargo information.
3 properties
ChecksumCheck
object
Checksum verification information.
2 properties
StatusHistory
object
5 properties
RestCollectionSipDataFile
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
RestCollectionLicense
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
DataFileChecksum
object
5 properties
PersonAvatar
object
7 properties
Deposit
object
A deposit is a simple package to prepare a SIP. Deposit status: - APPROVED = Approved deposit. The SIP preparation is in progress. - CANCELEDITINGMETADATA = A…
46 properties
DownloadToken
object
1 property
RestCollectionStatusHistory
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
InstitutionLogo
object
7 properties
FacetResult
object
3 properties
RepresentationInfo
object
OAIS Information Package: SIP, AIP or DIP.
16 properties
Result
object
The result is the result of REST action (HTTP POST) with the status: - EXECUTED = the action was executed successfully - NOTEXECUTED = the action failed and th…
5 properties
Contributor
object
Contributors are people who are involved in archives.
11 properties
ArchivalInfoPackage
object
Archival Information Package (AIP)
33 properties
LanguageDTO
object
4 properties
Cookie
object
1 property
RestCollectionArchivalInfoPackage
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
FileList
object
2 properties
DepositContributor
object
5 properties
DepositDataFile
object
24 properties
RestCollectionDeposit
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
RestCollectionPage
object
4 properties
VirusCheck
object
Virus check information.
3 properties
RestCollectionSubjectArea
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
RestCollectionDepositDataFile
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
SubjectArea
object
A subject area delineates a range of academic, administrative, and patrimonial disciplines. Each of these disciplines may follow its own classification system,…
9 properties
DepositContributorId
PreservationPolicy
object
A preservation policy defines whether approval is required for an AIP’s disposition as well as how long it should be kept.
10 properties
Link
object
8 properties
RestCollectionPerson
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
FileFormat
object
File format informations.
7 properties
SubmissionPolicy
object
A submission policy is a policy that can be associated to an SIP. It defines whether an SIP can submitted with or without approval and the amount of time it sh…
10 properties
OrcidToken
object
Personal token allowing to interact with ORCID API.
8 properties
Label
object
2 properties
SearchCriteria
object
6 properties
StreamingResponseBody
ArchiveType
object
Archive type based on DataCite notion.
7 properties
RestCollectionContributor
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties
Language
object
The language for internationalization (i18n) & localization (L10n)
8 properties
Tool
object
Software tool information.
4 properties
License
object
A license represents software licenses (Academic Free License 3.0, Design Science License, MIT License…​).
18 properties
Links
object
SipDataFile
object
24 properties
OrganizationalUnit
object
An organizational unit is a logical entity that represents a research project or laboratory or any other organizational group of researchers. A preservation sp…
17 properties
FacetResultValue
object
2 properties
Institution
object
An institution represents academic institutions, such as UNIGE and HES-SO.
12 properties
Pageable
object
3 properties
Person
object
A person is associated to a user on the platform. It contains information such as the person’s ORCID, institution and organizational units it belongs to.
12 properties
RestCollectionSubmissionInfoPackage
object
The structure of the REST response: - data: the list of objects - page: the pagination information - links: the HATEOAS links - facets: the search information
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

university-of-geneva-ingest-api-openapi.yml Raw ↑

Other APIs University of Geneva publishes across the network.

Archive ouverte UNIGE OAI-PMH
Terminus Protein Prediction API
University of Geneva Access API
University of Geneva OAI-PMH API
Where this information came from

This is an independent, third-party profile of University of Geneva Ingest API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.