DataCite Support

 

Version History

  • v.1: June 25, 2016, first draft.
  • v.1.1: October 10, 2016, follow JSONAPI spec for side-loading associations

Overview

The DataCite REST API returns information about DataCite content. The API is generally RESTFUL and returns results in JSON. It follows the JSONAPI specification. The mime-type for API results is application/vnd.api+json. There are two general types of results:

  • Singletons
  • Lists

Singletons

Singletons are single results. Retrieving metadata for a specific identifier (e.g. DOI, ORCID) typically returns a singleton result.

Lists

Lists results can contain multiple entries. Searching or filtering typically returns a list result. A list has three parts:

  • meta, which includes information about the query, e.g. number of results returned.
  • data, which will contain the items matching the query or filter.
  • included, which will contain side-loaded associations, via the ?include=x parameter.

Major resource components supported by the DataCite API are (in alphabetical order):

These can be used alone like this

Resource Description
/data-centers returns a list of all DataCite data centers
/members returns a list of all DataCite members
/works returns a list of all works (datasets, text documents, etc.), 25 per page

Resource components and identifiers

Resource components can be used in conjunction with identifiers to retrieve the metadata for that identifier.

Resource Description
/members/{member-id} returns metadata for a DataCite member
/data-centers/{data-center-id} returns metadata for a DataCite data center
/works/{doi} returns metadata for the specified DataCite DOI.

Notes on dates

Note that dates in filters should always be of the form YYYY-MM-DD, YYYY-MM or YYYY. Also note that the date published in DataCite metadata is always expressed as YYYY (the publicationYear field).

Rows

Normally, results are returned 25 at a time. You can control the number of results returns by using the rows parameter. To limit results to 5, for example, you could do the following:

# GET /works?query=
$ curl https://api.datacite.org/works?query=allen+renear&rows=5

If you would just like to get the summary of the results, you can set the rows to 0 (zero).

# GET /works?query=
$ curl https://api.datacite.org/works?query=allen+renear&rows=0

The maximum number rows you can ask for in one query is 1000.

Offset

The number of returned items is controlled by the rows parameter, but you can select the offset into the result list by using the offset parameter. So, for example, to select the second set of 5 results (i.e. results 6 through 10), you would do the following:

# GET /works?query=
$ curl https://api.datacite.org/works?query=allen+renear&rows=5&offset=5

Includes

To sideload associations use the include parameter, for example:

# GET /works?query=
$ curl https://api.datacite.org/works?query=climate&include=data-center,resource-type

Sideload multiple associations by providing them in a comma-separated list.

Notes on owner prefixes

The prefix of a DataCite DOI does NOT indicate who currently owns the DOI.

DataCite also has data-center_id (datacentre_symbol in the DataCite metadata) for depositing organisations. A single data center may control multiple owner prefixes, which in turn may control a number of DOIs. When looking at works published by a certain organisation, data_center_ids and the data center routes should be used.

Queries support a subset of DisMax, so, for example, you can refine queries as follows.

Works that include "renear" but not "ontologies":

GET /works?query=
$ curl https://api.datacite.org/works?query=renear+-ontologies

Sorting

Results from a list response can be sorted by applying the sort and order parameters. Order sets the result ordering, either asc or desc. Sort sets the field by which results will be sorted. Possible values are:

Sort value Description
score Sort by relevance score
updated Sort by date of most recent change to metadata
deposited Sort by time of most recent deposit
published Sort by publication date

An example that sorts results in order of publication, beginning with the least recent:

GET /works?query=
$ curl https://api.datacite.org/works?query=josiah+carberry&sort=published&order=asc

Facet Counts

Facet counts are returned via the meta object. Facet counts give counts per field value for an entire result set. The following facet counts are returned:

Resource Facet counts
/data centers total, members
/works total, data-centers, resource-types, schema-versions, sources, years

All other resources return only total in the meta object.

Filter Names

Filters allow you to narrow queries. All filter results are lists. The following filters are supported:

Filter Possible values Description
member-id {member-id} metadata associated with a specific DataCite member
data-center-id {data-center-id} metadata associated with a specific DataCite data center
resource-id {resource-type-id} metadata for a specific resourceTypeGeneral
source-id {source-id} metadata associated with a specific source
relation-type-id {relation-type-id} metadata associated with a specific relation type
from-created-date {date} metadata where deposited date is since (inclusive) {date}
until-created-date {date} metadata where deposited date is before (inclusive) {date}
from-update-date {date} metadata where updated date is since (inclusive) {date}
until-update-date {date} metadata where updated date is before (inclusive) {date}
year {year} publication year of the resource {year}

Rows

Normally, results are returned 25 at a time. You can control the number of results returns by using the rows parameter. To limit results to 5, for example, you could do the following:

# GET /works?query=
$ curl https://api.datacite.org/works?query=allen+renear&rows=5

If you would just like to get the summary of the results, you can set the rows to 0 (zero).

# GET /works?query=
$ curl https://api.datacite.org/works?query=allen+renear&rows=0

The maximum number rows you can ask for in one query is 1000.

Offset

The number of returned items is controlled by the rows parameter, but you can select the offset into the result list by using the offset parameter. So, for example, to select the second set of 5 results (i.e. results 6 through 10), you would do the following:

# GET /works?query=
$ curl https://api.datacite.org/works?query=allen+renear&rows=5&offset=5

Includes

To sideload associations (as specified in the JSONAPI documentation) use the include parameter, for example:

# GET /works?query=
$ curl https://api.datacite.org/works?query=climate&include=data-center,resource-type

Sideload multiple associations by providing them in a comma-separated list. The following resources can be sideloaded:

Resource Resources that can be included
/data-centers member
/works data-center, member, resource-type

When an error occurs, the API will return a JSONAPI error object, for example

{
  "errors": [
    {
      "status": "422",
      "title":  "Invalid Attribute"
    }
  ]
}

Further Details

Review or github repository for further details:
https://github.com/datacite/spinone

Suggest Edits

Get Data Center

Returns information about a specific data center

 
gethttps://api.datacite.org/data-centers/data-center-id

Path Params

data-center-id
string
required

returns metadata for a data center

Query Params

include
string

Comma-separated list from member

https://api.datacite.org/publishers/cdl.dryad?include=member,registration-agency
A binary file was returned

You couldn't be authenticated

{
    "data": {
        "id": "cdl.dryad",
        "type": "publishers",
        "attributes": {
            "title": "Dryad",
            "other-names": [],
            "prefixes": [],
            "member-id": "cdl",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:04:33Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "cdl",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    },
    "included": [{
        "id": "cdl",
        "type": "members",
        "attributes": {
            "title": "California Digital Library",
            "description": "<p>California Digital Library (CDL) handles scholarly information at every stage of its life. CDL provides technology and expertise to help the University of California (UC) collect, publish, access, and preserve its full range of information resources. CDL partners with organizations outside the UCs on far-reaching problems.</p>\n\n<p>CDL offers DataCite DOIs and other identifiers via the EZID service, a service CDL developed to help educational, non-profit, governmental and commercial clients create and manage globally unique identifiers for data and other sources.</p>\n",
            "member-type": "allocating",
            "region": "Americas",
            "country": "United States",
            "year": 2009,
            "logo-url": "https://assets.datacite.org/images/members/CDL.png",
            "email": "ezid@ucop.edu",
            "website": "http://ezid.cdlib.org",
            "phone": "1-510-987-0469",
            "updated": "2016-09-09T17:46:16.000Z"
        }
    }, {
        "id": "datacite",
        "type": "registration-agencies",
        "attributes": {
            "title": "DataCite",
            "updated": "2016-04-27T02:23:01Z"
        }
    }]
}
{
  "errors": [
    {
      "status": "404",
      "title": "The page you are looking for doesn't exist."
    }
  ]
}
Suggest Edits

List Data Centers

Returns information about a list of data centers.

 
gethttps://api.datacite.org/data-centers

Query Params

query
string

Query string, e.g. data center name

member-id
string

Member that the data center is associated with

offset
int32
rows
int32
include
string

Comma-separated list from member

http://api.datacite.org/data-centers?member-id=delft&include=member
A binary file was returned

You couldn't be authenticated

{
    "data": [{
        "id": "delft.datacent",
        "type": "publishers",
        "attributes": {
            "title": "3TU Datacentrum",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T19:40:58Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.data4-tu",
        "type": "publishers",
        "attributes": {
            "title": "4TU.Centre for Research Data",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T19:40:58Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.easy",
        "type": "publishers",
        "attributes": {
            "title": "DANS-EASY",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:01:43Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.tpm",
        "type": "publishers",
        "attributes": {
            "title": "Faculty of Technology, Policy and Management, TU Delft",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:11:33Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.iea",
        "type": "publishers",
        "attributes": {
            "title": "International Association for the Evaluation of Educational Achievement",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:26:23Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.isric",
        "type": "publishers",
        "attributes": {
            "title": "ISRIC",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:32:11Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.jrc",
        "type": "publishers",
        "attributes": {
            "title": "Joint Research Centre's Institute of Energy",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:38:06Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.maastro",
        "type": "publishers",
        "attributes": {
            "title": "MAASTRO Clinic",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:52:54Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.nibg",
        "type": "publishers",
        "attributes": {
            "title": "Nederlands Instituut voor Beeld en Geluid",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:55:57Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.tudarch",
        "type": "publishers",
        "attributes": {
            "title": "TU Delft Architecture",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:41:17Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.tudelft",
        "type": "publishers",
        "attributes": {
            "title": "TU Delft Library",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:44:02Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.tue",
        "type": "publishers",
        "attributes": {
            "title": "TU Eindhoven",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T20:44:03Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.eur",
        "type": "publishers",
        "attributes": {
            "title": "Universiteitsbibliotheek EUR",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T21:02:34Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }, {
        "id": "delft.vliz",
        "type": "publishers",
        "attributes": {
            "title": "VLIZ - Vlaams Instituut voor de Zee",
            "other-names": [],
            "prefixes": [],
            "member-id": "delft",
            "registration-agency-id": "datacite",
            "updated": "2017-01-04T19:37:44Z"
        },
        "relationships": {
            "member": {
                "data": {
                    "id": "delft",
                    "type": "members"
                }
            },
            "registration-agency": {
                "data": {
                    "id": "datacite",
                    "type": "registration-agencies"
                }
            }
        }
    }],
    "included": [{
        "id": "delft",
        "type": "members",
        "attributes": {
            "title": "TU Delft Library",
            "description": "<p>The TU Delft Library is the hub of knowledge for technical and scientific information and the largest technical-scientific library in the Netherlands. We support research and education at the national level and are part of the Delft University of Technology. TU Delft Library is a founding member of DataCite and a regional office for the Netherlands.</p>\n\n<p>TU Delft Library has established DataCite Netherlands to serve as a central research dataset registration service that will enable Dutch research organizations to register research datasets and assign digital object identifiers (DOIs) to them. Our aim is to support researchers by improving access to research data and to increase acceptance of the research data as legitimate, citable contributions to scientific record through trustworthy registration and identification of datasets. The current focus of DataCite Netherlands is on promoting the use of digital object identifiers for datasets.</p>\n",
            "member-type": "allocating",
            "region": "EMEA",
            "country": "Netherlands",
            "year": 2009,
            "logo-url": "https://assets.datacite.org/images/members/DELFT.png",
            "email": "library@tudelft.nl",
            "website": "http://www.library.tudelft.nl/en",
            "phone": "+31 15 27 85678",
            "updated": "2016-07-31T23:38:25.000Z"
        }
    }, {
        "id": "datacite",
        "type": "registration-agencies",
        "attributes": {
            "title": "DataCite",
            "updated": "2016-04-27T02:23:01Z"
        }
    }],
    "meta": {
        "total": 14,
        "registration-agencies": [{
            "id": "datacite",
            "title": "DataCite",
            "count": 14
        }],
        "members": [{
            "id": "delft",
            "title": "TU Delft Library",
            "count": 14
        }]
    }
}
Suggest Edits

Get Member

Returns information about a DataCite member.

 
gethttps://api.datacite.org/members/member-id

Path Params

member-id
string
required

returns metadata for a DataCite member

curl https://api.datacite.org/members/cern
A binary file was returned

You couldn't be authenticated

{
  "data": {
    "id": "cern",
    "type": "members",
    "attributes": {
      "title": "European Organization for Nuclear Research",
      "description": "<p>CERN, the European Organization for Nuclear Research, is the world&#39;s largest particle physics laboratory. Founded in 1954 and based on the Franco-Swiss border near Geneva, it was one of Europe&#39;s first joint ventures and now has 21 member states and more than 50 cooperation agreements and scientific contacts with other countries.</p>\n\n<p>At CERN, physicists and engineers probe the fundamental structure of the universe. They use the world&#39;s largest and most complex scientific instrument, the Large Hadron Collider (LHC), to study the basic constituents of matter. The results of their experimental and theoretical work are publicly available following CERN&#39;s Open Access Policy.</p>\n\n<p>CERN services implementing DOIs are its institutional repository (CDS, CERN Document Server); INSPIRE-HEP, a digital library for the field of High-Energy Physics run in collaboration with other institutions; or the CERN Open Data Portal, which provides high level and analyzable data and software from the LHC experiments.</p>\n\n<p>Furthermore, CERN is also providing DOIs to ZENODO, a multidisciplinary data repository for the “long tail” of research results. It allows researchers to share and preserve their output independent of size, type of material or discipline.</p>\n",
      "member-type": "allocating",
      "region": "EMEA",
      "country": "Switzerland",
      "year": 2014,
      "logo-url": "https://assets.datacite.org/images/members/CERN.png",
      "email": "doi-service@cern.ch",
      "website": "http://doi.web.cern.ch/",
      "phone": null,
      "updated": "2016-07-31T21:30:25.000Z"
    }
  }
}
{
  "errors": [
    {
      "status": "404",
      "title": "The page you are looking for doesn't exist."
    }
  ]
}
Suggest Edits

List Members

Returns information about a list of DataCite members.

 
gethttps://api.datacite.org/members

Query Params

query
string

query string, e.g. member name

member-type
string

member type (allocating or non-allocating)

region
string

Geographic region (one of amer, apac, emea)

year
string

Year member joined DataCite

curl https://api.datacite.org/members
A binary file was returned

You couldn't be authenticated

{
  "data": [
    {
      "id": "ands",
      "type": "members",
      "attributes": {
        "title": "Australian National Data Service",
        "description": "<p>The Australian National Data Service (ANDS) makes Australia&#39;s research data assets more valuable for researchers, research institutions and the nation.</p>\n\n<p>We do this through working in trusted partnerships on research data projects, delivering reliable national services and enhancing the capability of Australia&#39;s research data system.</p>\n\n<p>A key ANDS service is the <a href=\"http://researchdata.ands.org.au/\">Research Data Australia</a> discovery portal where you can find, access and reuse Australian research data.</p>\n\n<p>ANDS is a partnership led by Monash University, in collaboration with the Australian National University and CSIRO. It is funded by the Australian Government through the National Collaborative Research Infrastructure Strategy (NCRIS).</p>\n\n<p>ANDS involvement in the DataCite consortium ensures that we are active in global initiatives addressing the issues surrounding research data, including those of publication, citation and standards. ANDS has run its <a href=\"http://ands.org.au/services/cite-my-data.html\">Cite My Data</a> service since 2011. This service allows Australian research organisations to assign DOIs to their own research collections. This, in turn, provides researchers with a means of citing their published data and achieving recognition for their research data output.</p>\n\n<p>Subscribe to our discussion list: <a href=\"https://groups.google.com/forum/?hl=en#!forum/ands-general\">ANDS Google Group</a>.</p>\n\n<p>Subscribe to our e-newsletter: <a href=\"http://us7.campaign-archive2.com/home/?u=b542ef52e49302569068046d9&amp;id=22b849a4ee\">andsUP</a>.</p>\n",
        "member-type": "allocating",
        "region": "Asia Pacific",
        "country": "Australia",
        "year": 2010,
        "logo-url": "https://assets.datacite.org/images/members/ands.png",
        "email": "contact@ands.org.au",
        "website": "http://www.ands.org.au",
        "phone": "+61 3 9902 0585",
        "updated": "2017-01-10T19:06:20.000Z"
      }
    },
    {
      "id": "snd",
      "type": "members",
      "attributes": {
        "title": "Swedish National Data Service",
        "description": "<p>The Swedish National Data Service (SND) is a national infrastructure for Swedish research within the humanities, social sciences and health sciences. SND offers support to Swedish research by facilitating researchers’ access to data within and outside of Sweden. SND also provides support and guidance to researchers throughout the whole research process.<br>\nAn important part of SND’s mission is to gain a very good overview of existing research databases and to endeavour to gain full knowledge of future databases. Our main task is to take stock of databases relevant to research as well as support archiving, usage and re-usage of databases and related research materials on a national level within SND’s fields of responsibility.</p>\n\n<p>SND is the Swedish node in an international network of data archives (CESSDA). This network is an important part of the global research infrastructure and helps SND to present Swedish research outside of Sweden.</p>\n",
        "member-type": "allocating",
        "region": "EMEA",
        "country": "Sweden",
        "year": 2010,
        "logo-url": "https://assets.datacite.org/images/members/snd.png",
        "email": "pid@snd.gu.se",
        "website": "http://snd.gu.se/en",
        "phone": "+46 31 786 12 06",
        "updated": "2016-09-01T17:15:12.000Z"
      }
    }
  ],
  "meta": {
    "total": 2,
    "member-types": [
      {
        "id": "allocating",
        "title": "Allocating",
        "count": 2
      }
    ],
    "regions": [
      {
        "id": "apac",
        "title": "Asia and Pacific",
        "count": 1
      },
      {
        "id": "emea",
        "title": "Europe, Middle East and Africa",
        "count": 1
      }
    ],
    "years": [
      {
        "id": "2010",
        "title": "2010",
        "count": 2
      }
    ]
  }
}
Suggest Edits

Get Person

Returns information about a person.

 
gethttps://api.datacite.org/people/person-id

Path Params

person-id
string
required
curl https://api.datacite.org/peope
A binary file was returned

You couldn't be authenticated

{
  "data": [
    {
      "id": "http://orcid.org/0000-0002-7304-0535",
      "type": "contributors",
      "attributes": {
        "given": "Ronald",
        "family": "Aarts",
        "literal": null,
        "orcid": "0000-0002-7304-0535",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-6914-2224",
      "type": "contributors",
      "attributes": {
        "given": "nurul syakima",
        "family": "ab mutalib",
        "literal": null,
        "orcid": "0000-0001-6914-2224",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-1265-4186",
      "type": "contributors",
      "attributes": {
        "given": "Cecilia",
        "family": "Abadie",
        "literal": null,
        "orcid": "0000-0003-1265-4186",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-7214-2986",
      "type": "contributors",
      "attributes": {
        "given": "Naeem",
        "family": "Abas",
        "literal": null,
        "orcid": "0000-0002-7214-2986",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4829-3204",
      "type": "contributors",
      "attributes": {
        "given": "Irina",
        "family": "Abaturova",
        "literal": null,
        "orcid": "0000-0003-4829-3204",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-9345-5407",
      "type": "contributors",
      "attributes": {
        "given": "Simona",
        "family": "Abbà",
        "literal": null,
        "orcid": "0000-0001-9345-5407",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-8001-328X",
      "type": "contributors",
      "attributes": {
        "given": "Eslam",
        "family": "Abbas",
        "literal": null,
        "orcid": "0000-0001-8001-328X",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-3721-6054",
      "type": "contributors",
      "attributes": {
        "given": "Mohammad Reza",
        "family": "Abbasi",
        "literal": null,
        "orcid": "0000-0002-3721-6054",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4805-8714",
      "type": "contributors",
      "attributes": {
        "given": "Iftikhar",
        "family": "Abbasov",
        "literal": null,
        "orcid": "0000-0003-4805-8714",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-0899-0232",
      "type": "contributors",
      "attributes": {
        "given": "Abbas",
        "family": "Abbaszadeh",
        "literal": null,
        "orcid": "0000-0003-0899-0232",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4713-6098",
      "type": "contributors",
      "attributes": {
        "given": "Dallas",
        "family": "Abbott",
        "literal": null,
        "orcid": "0000-0003-4713-6098",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-6347-9499",
      "type": "contributors",
      "attributes": {
        "given": "Peter",
        "family": "Abbott",
        "literal": null,
        "orcid": "0000-0002-6347-9499",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-4666-3681",
      "type": "contributors",
      "attributes": {
        "given": "Kasper",
        "family": "Abcouwer",
        "literal": null,
        "orcid": "0000-0002-4666-3681",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4488-3063",
      "type": "contributors",
      "attributes": {
        "given": "Leonardo",
        "family": "Abdala Elias",
        "literal": null,
        "orcid": "0000-0003-4488-3063",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-6558-7207",
      "type": "contributors",
      "attributes": {
        "given": "Ahmed",
        "family": "Abdalla Alemam Mohamed",
        "literal": null,
        "orcid": "0000-0002-6558-7207",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-6831-1524",
      "type": "contributors",
      "attributes": {
        "given": "Aly",
        "family": "Abdel-Moemin",
        "literal": null,
        "orcid": "0000-0001-6831-1524",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4438-8572",
      "type": "contributors",
      "attributes": {
        "given": "Ahmed",
        "family": "Abdelhady",
        "literal": null,
        "orcid": "0000-0003-4438-8572",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-3863-3749",
      "type": "contributors",
      "attributes": {
        "given": "Ayman",
        "family": "Abdelhai",
        "literal": null,
        "orcid": "0000-0002-3863-3749",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-8232-1403",
      "type": "contributors",
      "attributes": {
        "given": "Boumediene",
        "family": "Abdellaoui",
        "literal": null,
        "orcid": "0000-0001-8232-1403",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-1014-6922",
      "type": "contributors",
      "attributes": {
        "given": "Usama Ramadan",
        "family": "Abdelmohsen",
        "literal": null,
        "orcid": "0000-0002-1014-6922",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-5618-9637",
      "type": "contributors",
      "attributes": {
        "given": "Noorizan",
        "family": "Abdul Majid",
        "literal": null,
        "orcid": "0000-0002-5618-9637",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-6257-876X",
      "type": "contributors",
      "attributes": {
        "given": "Alfie",
        "family": "Abdul-Rahman",
        "literal": null,
        "orcid": "0000-0002-6257-876X",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-1745-5952",
      "type": "contributors",
      "attributes": {
        "given": "Ayako",
        "family": "Abe-Ouchi",
        "literal": null,
        "orcid": "0000-0003-1745-5952",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-3915-8342",
      "type": "contributors",
      "attributes": {
        "given": "Daniel",
        "family": "Abel-Schaad",
        "literal": null,
        "orcid": "0000-0003-3915-8342",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-1122-6622",
      "type": "contributors",
      "attributes": {
        "given": "Carlos",
        "family": "Abellán",
        "literal": null,
        "orcid": "0000-0003-1122-6622",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    }
  ],
  "meta": {
    "total": 7141
  }
}
{
  "errors": [
    {
      "status": "404",
      "title": "The page you are looking for doesn't exist."
    }
  ]
}
Suggest Edits

List People

Returns information about a list of people.

 
gethttps://api.datacite.org/contributors/

Query Params

rows
int32
offset
int32
sort
string

can be deposited, published, updated or score

order
string

can be asc or desc

include
string

comma-separated list from publisher, member, registration-agency, resource-type and work-type

curl https://api.datacite.org/contributors
A binary file was returned

You couldn't be authenticated

{
  "data": [
    {
      "id": "http://orcid.org/0000-0002-7304-0535",
      "type": "contributors",
      "attributes": {
        "given": "Ronald",
        "family": "Aarts",
        "literal": null,
        "orcid": "0000-0002-7304-0535",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-6914-2224",
      "type": "contributors",
      "attributes": {
        "given": "nurul syakima",
        "family": "ab mutalib",
        "literal": null,
        "orcid": "0000-0001-6914-2224",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-1265-4186",
      "type": "contributors",
      "attributes": {
        "given": "Cecilia",
        "family": "Abadie",
        "literal": null,
        "orcid": "0000-0003-1265-4186",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-7214-2986",
      "type": "contributors",
      "attributes": {
        "given": "Naeem",
        "family": "Abas",
        "literal": null,
        "orcid": "0000-0002-7214-2986",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4829-3204",
      "type": "contributors",
      "attributes": {
        "given": "Irina",
        "family": "Abaturova",
        "literal": null,
        "orcid": "0000-0003-4829-3204",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-9345-5407",
      "type": "contributors",
      "attributes": {
        "given": "Simona",
        "family": "Abbà",
        "literal": null,
        "orcid": "0000-0001-9345-5407",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-8001-328X",
      "type": "contributors",
      "attributes": {
        "given": "Eslam",
        "family": "Abbas",
        "literal": null,
        "orcid": "0000-0001-8001-328X",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-3721-6054",
      "type": "contributors",
      "attributes": {
        "given": "Mohammad Reza",
        "family": "Abbasi",
        "literal": null,
        "orcid": "0000-0002-3721-6054",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4805-8714",
      "type": "contributors",
      "attributes": {
        "given": "Iftikhar",
        "family": "Abbasov",
        "literal": null,
        "orcid": "0000-0003-4805-8714",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-0899-0232",
      "type": "contributors",
      "attributes": {
        "given": "Abbas",
        "family": "Abbaszadeh",
        "literal": null,
        "orcid": "0000-0003-0899-0232",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4713-6098",
      "type": "contributors",
      "attributes": {
        "given": "Dallas",
        "family": "Abbott",
        "literal": null,
        "orcid": "0000-0003-4713-6098",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-6347-9499",
      "type": "contributors",
      "attributes": {
        "given": "Peter",
        "family": "Abbott",
        "literal": null,
        "orcid": "0000-0002-6347-9499",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-4666-3681",
      "type": "contributors",
      "attributes": {
        "given": "Kasper",
        "family": "Abcouwer",
        "literal": null,
        "orcid": "0000-0002-4666-3681",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4488-3063",
      "type": "contributors",
      "attributes": {
        "given": "Leonardo",
        "family": "Abdala Elias",
        "literal": null,
        "orcid": "0000-0003-4488-3063",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-6558-7207",
      "type": "contributors",
      "attributes": {
        "given": "Ahmed",
        "family": "Abdalla Alemam Mohamed",
        "literal": null,
        "orcid": "0000-0002-6558-7207",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-6831-1524",
      "type": "contributors",
      "attributes": {
        "given": "Aly",
        "family": "Abdel-Moemin",
        "literal": null,
        "orcid": "0000-0001-6831-1524",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-4438-8572",
      "type": "contributors",
      "attributes": {
        "given": "Ahmed",
        "family": "Abdelhady",
        "literal": null,
        "orcid": "0000-0003-4438-8572",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-3863-3749",
      "type": "contributors",
      "attributes": {
        "given": "Ayman",
        "family": "Abdelhai",
        "literal": null,
        "orcid": "0000-0002-3863-3749",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0001-8232-1403",
      "type": "contributors",
      "attributes": {
        "given": "Boumediene",
        "family": "Abdellaoui",
        "literal": null,
        "orcid": "0000-0001-8232-1403",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-1014-6922",
      "type": "contributors",
      "attributes": {
        "given": "Usama Ramadan",
        "family": "Abdelmohsen",
        "literal": null,
        "orcid": "0000-0002-1014-6922",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-5618-9637",
      "type": "contributors",
      "attributes": {
        "given": "Noorizan",
        "family": "Abdul Majid",
        "literal": null,
        "orcid": "0000-0002-5618-9637",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0002-6257-876X",
      "type": "contributors",
      "attributes": {
        "given": "Alfie",
        "family": "Abdul-Rahman",
        "literal": null,
        "orcid": "0000-0002-6257-876X",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-1745-5952",
      "type": "contributors",
      "attributes": {
        "given": "Ayako",
        "family": "Abe-Ouchi",
        "literal": null,
        "orcid": "0000-0003-1745-5952",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-3915-8342",
      "type": "contributors",
      "attributes": {
        "given": "Daniel",
        "family": "Abel-Schaad",
        "literal": null,
        "orcid": "0000-0003-3915-8342",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    },
    {
      "id": "http://orcid.org/0000-0003-1122-6622",
      "type": "contributors",
      "attributes": {
        "given": "Carlos",
        "family": "Abellán",
        "literal": null,
        "orcid": "0000-0003-1122-6622",
        "github": null,
        "updated": "1970-01-01T00:00:00Z"
      }
    }
  ],
  "meta": {
    "total": 7141
  }
}
{
  "errors": [
    {
      "status": "404",
      "title": "The page you are looking for doesn't exist."
    }
  ]
}
Suggest Edits

Get Work

Returns the metadata for the specified DOI

 
gethttps://api.datacite.org/works/doi

Path Params

doi
string
required
curl https://api.datacite.org/works/10.5438/0012
A binary file was returned

You couldn't be authenticated

{
  "errors": [
    {
      "status": "404",
      "title": "The page you are looking for doesn't exist."
    }
  ]
}
{
  "data": {
    "id": "https://doi.org/10.5438/0012",
    "type": "works",
    "attributes": {
      "doi": "10.5438/0012",
      "url": null,
      "author": [
        {
          "literal": "DataCite Metadata Working Group"
        }
      ],
      "title": "DataCite Metadata Schema Documentation for the Publication and Citation of Research Data v4.0",
      "container-title": "DataCite e.V.",
      "description": "1 Introduction\n1.1 The DataCite Consortium\n1.2 DataCite Community Participation\n1.3 The Metadata Schema\n1.4 Version 4.0 Update\n2 DataCite Metadata Properties\n2.1 Overview\n2.2 Citation\n2.3 DataCite Properties\n3 XML Example\n4 XML Schema\n5 Other DataCite Services\nAppendices\nAppendix 1: Controlled List Definitions\nAppendix 2: Earlier Version Update Notes",
      "resource-type-subtype": "Documentation",
      "publisher-id": "datacite.datacite",
      "member-id": "datacite",
      "registration-agency-id": "datacite",
      "resource-type-id": "text",
      "work-type-id": "report",
      "version": "4.0",
      "license": null,
      "schema-version": "4",
      "results": [],
      "published": "2016",
      "deposited": "2016-09-19T21:53:56Z",
      "updated": "2016-09-19T22:16:45Z",
      "media": null,
      "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxyZXNvdXJjZSB4bWxucz0iaHR0cDovL2RhdGFjaXRlLm9yZy9zY2hlbWEva2VybmVsLTQiIHhtbG5zOnhzaT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEtaW5zdGFuY2UiIHhzaTpzY2hlbWFMb2NhdGlvbj0iaHR0cDovL2RhdGFjaXRlLm9yZy9zY2hlbWEva2VybmVsLTQgaHR0cDovL3NjaGVtYS5kYXRhY2l0ZS5vcmcvbWV0YS9rZXJuZWwtNC9tZXRhZGF0YS54c2QiPg0KCTxpZGVudGlmaWVyIGlkZW50aWZpZXJUeXBlPSJET0kiPjEwLjU0MzgvMDAxMjwvaWRlbnRpZmllcj4NCgk8Y3JlYXRvcnM+DQoJCTxjcmVhdG9yPg0KCQkJPGNyZWF0b3JOYW1lPkRhdGFDaXRlIE1ldGFkYXRhIFdvcmtpbmcgR3JvdXA8L2NyZWF0b3JOYW1lPg0KCQk8L2NyZWF0b3I+DQoJPC9jcmVhdG9ycz4NCgk8dGl0bGVzPg0KCQk8dGl0bGU+RGF0YUNpdGUgTWV0YWRhdGEgU2NoZW1hIERvY3VtZW50YXRpb24gZm9yIHRoZSBQdWJsaWNhdGlvbiBhbmQgQ2l0YXRpb24gb2YgUmVzZWFyY2ggRGF0YSB2NC4wPC90aXRsZT4NCgk8L3RpdGxlcz4NCgk8cHVibGlzaGVyPkRhdGFDaXRlIGUuVi48L3B1Ymxpc2hlcj4NCgk8cHVibGljYXRpb25ZZWFyPjIwMTY8L3B1YmxpY2F0aW9uWWVhcj4NCgk8Y29udHJpYnV0b3JzPg0KCQk8Y29udHJpYnV0b3IgY29udHJpYnV0b3JUeXBlPSJQcm9qZWN0TGVhZGVyIj4NCgkJCTxjb250cmlidXRvck5hbWU+U3RhcnIsIEpvYW48L2NvbnRyaWJ1dG9yTmFtZT4NCgkJCTxnaXZlbk5hbWU+Sm9hbjwvZ2l2ZW5OYW1lPg0KCQkJPGZhbWlseU5hbWU+U3RhcnI8L2ZhbWlseU5hbWU+DQoJCQk8bmFtZUlkZW50aWZpZXIgbmFtZUlkZW50aWZpZXJTY2hlbWU9Ik9SQ0lEIiBzY2hlbWVVUkk9Imh0dHA6Ly9vcmNpZC5vcmciPjAwMDAtMDAwMi03Mjg1LTAyN1g8L25hbWVJZGVudGlmaWVyPg0KCQkJPGFmZmlsaWF0aW9uPkNhbGlmb3JuaWEgRGlnaXRhbCBMaWJyYXJ5PC9hZmZpbGlhdGlvbj4NCgkJPC9jb250cmlidXRvcj4NCgkJPGNvbnRyaWJ1dG9yIGNvbnRyaWJ1dG9yVHlwZT0iUHJvamVjdExlYWRlciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPlNtYWVsZSwgTWFkZWxlaW5lIGRlPC9jb250cmlidXRvck5hbWU+DQoJCQk8Z2l2ZW5OYW1lPk1hZGVsZWluZSBkZTwvZ2l2ZW5OYW1lPg0KCQkJPGZhbWlseU5hbWU+U21hZWxlPC9mYW1pbHlOYW1lPg0KCQkJPGFmZmlsaWF0aW9uPlRVIERlbGZ0PC9hZmZpbGlhdGlvbj4NCgkJPC9jb250cmlidXRvcj4NCgkJPGNvbnRyaWJ1dG9yIGNvbnRyaWJ1dG9yVHlwZT0iRWRpdG9yIj4NCgkJCTxjb250cmlidXRvck5hbWU+QXNodG9uLCBKYW48L2NvbnRyaWJ1dG9yTmFtZT4NCgkJCTxnaXZlbk5hbWU+SmFuPC9naXZlbk5hbWU+DQoJCQk8ZmFtaWx5TmFtZT5Bc2h0b248L2ZhbWlseU5hbWU+DQoJCQk8YWZmaWxpYXRpb24+QnJpdGlzaCBMaWJyYXJ5PC9hZmZpbGlhdGlvbj4NCgkJPC9jb250cmlidXRvcj4NCgkJPGNvbnRyaWJ1dG9yIGNvbnRyaWJ1dG9yVHlwZT0iRWRpdG9yIj4NCgkJCTxjb250cmlidXRvck5hbWU+QmFydG9uLCBBbXk8L2NvbnRyaWJ1dG9yTmFtZT4NCgkJCTxnaXZlbk5hbWU+QW15PC9naXZlbk5hbWU+DQoJCQk8ZmFtaWx5TmFtZT5CYXJ0b248L2ZhbWlseU5hbWU+DQoJCQk8YWZmaWxpYXRpb24+UHVyZHVlIFVuaXZlcnNpdHkgTGlicmFyeTwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCTxjb250cmlidXRvciBjb250cmlidXRvclR5cGU9IkVkaXRvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPkJyYWRmb3JkLCBUaW5hPC9jb250cmlidXRvck5hbWU+DQoJCQk8Z2l2ZW5OYW1lPlRpbmE8L2dpdmVuTmFtZT4NCgkJCTxmYW1pbHlOYW1lPkJyYWRmb3JkPC9mYW1pbHlOYW1lPg0KCQkJPGFmZmlsaWF0aW9uPk5SQy9DSVNUSTwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCTxjb250cmlidXRvciBjb250cmlidXRvclR5cGU9IkVkaXRvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPkNpb2xla+KAkEZpZ2llbCwgQW5uZTwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5Bbm5lPC9naXZlbk5hbWU+DQoJCQk8ZmFtaWx5TmFtZT5DaW9sZWstRmlnaWVsPC9mYW1pbHlOYW1lPg0KCQkJPGFmZmlsaWF0aW9uPkluaXN04oCQQ05SUzwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCTxjb250cmlidXRvciBjb250cmlidXRvclR5cGU9IkVkaXRvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPkRpZXRpa2VyLCBTdGVmYW5pZTwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5TdGVmYW5pZTwvZ2l2ZW5OYW1lPg0KCQkJPGZhbWlseU5hbWU+RGlldGlrZXI8L2ZhbWlseU5hbWU+DQoJCQk8YWZmaWxpYXRpb24+RVRIIFrDvHJpY2g8L2FmZmlsaWF0aW9uPg0KCQk8L2NvbnRyaWJ1dG9yPg0KCQk8Y29udHJpYnV0b3IgY29udHJpYnV0b3JUeXBlPSJFZGl0b3IiPg0KCQkJPGNvbnRyaWJ1dG9yTmFtZT5FbGxpb3R0LCBKYW5uZWFuPC9jb250cmlidXRvck5hbWU+DQoJCQk8Z2l2ZW5OYW1lPkphbm5lYW48L2dpdmVuTmFtZT4NCgkJCTxmYW1pbHlOYW1lPkVsbGlvdDwvZmFtaWx5TmFtZT4NCgkJCTxhZmZpbGlhdGlvbj5ET0UvT1NUSTwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCTxjb250cmlidXRvciBjb250cmlidXRvclR5cGU9IkVkaXRvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPkdlbmF0LCBCZXJyaXQ8L2NvbnRyaWJ1dG9yTmFtZT4NCgkJCTxnaXZlbk5hbWU+QmVycml0PC9naXZlbk5hbWU+DQoJCQk8ZmFtaWx5TmFtZT5HZW5hdDwvZmFtaWx5TmFtZT4NCgkJCTxhZmZpbGlhdGlvbj5USUI8L2FmZmlsaWF0aW9uPg0KCQk8L2NvbnRyaWJ1dG9yPg0KCQk8Y29udHJpYnV0b3IgY29udHJpYnV0b3JUeXBlPSJFZGl0b3IiPg0KCQkJPGNvbnRyaWJ1dG9yTmFtZT5IYXJ6ZW5ldHRlciwgS2Fyb2xpbmU8L2NvbnRyaWJ1dG9yTmFtZT4NCgkJCTxnaXZlbk5hbWU+S2Fyb2xpbmU8L2dpdmVuTmFtZT4NCgkJCTxmYW1pbHlOYW1lPkhhcnplbmV0dGVyPC9mYW1pbHlOYW1lPg0KCQkJPGFmZmlsaWF0aW9uPkdFU0lTPC9hZmZpbGlhdGlvbj4NCgkJPC9jb250cmlidXRvcj4NCgkJPGNvbnRyaWJ1dG9yIGNvbnRyaWJ1dG9yVHlwZT0iRWRpdG9yIj4NCgkJCTxjb250cmlidXRvck5hbWU+SGlyc2NobWFubiwgQmFyYmFyYTwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5CYXJiYXJhPC9naXZlbk5hbWU+DQoJCQk8ZmFtaWx5TmFtZT5IaXJzY2htYW5uPC9mYW1pbHlOYW1lPg0KCQkJPG5hbWVJZGVudGlmaWVyIG5hbWVJZGVudGlmaWVyU2NoZW1lPSJPUkNJRCIgc2NoZW1lVVJJPSJodHRwOi8vb3JjaWQub3JnIj4wMDAwLTAwMDMtMDI4OS0wMzQ1PC9uYW1lSWRlbnRpZmllcj4NCgkJCTxhZmZpbGlhdGlvbj5FVEggWsO8cmljaDwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCTxjb250cmlidXRvciBjb250cmlidXRvclR5cGU9IkVkaXRvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPkpha29ic3NvbiwgU3RlZmFuPC9jb250cmlidXRvck5hbWU+DQoJCQk8Z2l2ZW5OYW1lPlN0ZWZhbjwvZ2l2ZW5OYW1lPg0KCQkJPGZhbWlseU5hbWU+SmFrb2Jzc29uPC9mYW1pbHlOYW1lPg0KCQkJPGFmZmlsaWF0aW9uPlNORDwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCTxjb250cmlidXRvciBjb250cmlidXRvclR5cGU9IkVkaXRvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPk1haWxsb3V4LCBKZWFu4oCQWXZlczwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5KZWFuLVl2ZXM8L2dpdmVuTmFtZT4NCgkJCTxmYW1pbHlOYW1lPk1haWxsb3V4PC9mYW1pbHlOYW1lPg0KCQkJPGFmZmlsaWF0aW9uPk5SQy9DSVNUSTwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCTxjb250cmlidXRvciBjb250cmlidXRvclR5cGU9IkVkaXRvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPk5ld2JvbGQsIEVsaXphYmV0aDwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5FbGl6YWJldGg8L2dpdmVuTmFtZT4NCgkJCTxmYW1pbHlOYW1lPk5ld2JvbGQ8L2ZhbWlseU5hbWU+DQoJCQk8bmFtZUlkZW50aWZpZXIgbmFtZUlkZW50aWZpZXJTY2hlbWU9Ik9SQ0lEIiBzY2hlbWVVUkk9Imh0dHA6Ly9vcmNpZC5vcmciPjAwMDAtMDAwMi04MjU1LTkwMTM8L25hbWVJZGVudGlmaWVyPg0KCQkJPGFmZmlsaWF0aW9uPkJyaXRpc2ggTGlicmFyeTwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJCQkJPGNvbnRyaWJ1dG9yIGNvbnRyaWJ1dG9yVHlwZT0iRWRpdG9yIj4NCgkJCTxjb250cmlidXRvck5hbWU+TmllbHNlbiwgTGFycyBIb2xtIDwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5MYXJzIEhvbG08L2dpdmVuTmFtZT4NCgkJCTxmYW1pbHlOYW1lPk5pZWxzZW48L2ZhbWlseU5hbWU+DQoJCQk8bmFtZUlkZW50aWZpZXIgbmFtZUlkZW50aWZpZXJTY2hlbWU9Ik9SQ0lEIiBzY2hlbWVVUkk9Imh0dHA6Ly9vcmNpZC5vcmciPjAwMDAtMDAwMS04MTM1LTM0ODk8L25hbWVJZGVudGlmaWVyPg0KCQkJPGFmZmlsaWF0aW9uPkNFUk48L2FmZmlsaWF0aW9uPg0KCQk8L2NvbnRyaWJ1dG9yPg0KCQk8Y29udHJpYnV0b3IgY29udHJpYnV0b3JUeXBlPSJFZGl0b3IiPg0KCQkJPGNvbnRyaWJ1dG9yTmFtZT5ZYWhpYSwgTW9oYW1lZDwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5Nb2hhbWVkPC9naXZlbk5hbWU+DQoJCQk8ZmFtaWx5TmFtZT5ZYWhpYTwvZmFtaWx5TmFtZT4NCgkJCTxhZmZpbGlhdGlvbj5JbmlzdC1DTlJTPC9hZmZpbGlhdGlvbj4NCgkJPC9jb250cmlidXRvcj4NCgkJPGNvbnRyaWJ1dG9yIGNvbnRyaWJ1dG9yVHlwZT0iU3VwZXJ2aXNvciI+DQoJCQk8Y29udHJpYnV0b3JOYW1lPlppZWRvcm4sIEZyYXVrZTwvY29udHJpYnV0b3JOYW1lPg0KCQkJPGdpdmVuTmFtZT5GcmF1a2U8L2dpdmVuTmFtZT4NCgkJCTxmYW1pbHlOYW1lPlppZWRvcm48L2ZhbWlseU5hbWU+DQoJCQk8bmFtZUlkZW50aWZpZXIgbmFtZUlkZW50aWZpZXJTY2hlbWU9Ik9SQ0lEIiBzY2hlbWVVUkk9Imh0dHA6Ly9vcmNpZC5vcmciPjAwMDAtMDAwMi0xMTQzLTc4MVg8L25hbWVJZGVudGlmaWVyPg0KCQkJPGFmZmlsaWF0aW9uPlRJQjwvYWZmaWxpYXRpb24+DQoJCTwvY29udHJpYnV0b3I+DQoJPC9jb250cmlidXRvcnM+DQoJPGxhbmd1YWdlPmVuZzwvbGFuZ3VhZ2U+DQoJPHJlc291cmNlVHlwZSByZXNvdXJjZVR5cGVHZW5lcmFsPSJUZXh0Ij5Eb2N1bWVudGF0aW9uPC9yZXNvdXJjZVR5cGU+DQoJPHJlbGF0ZWRJZGVudGlmaWVycz4NCgkJPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IkRvY3VtZW50cyI+MTAuNTQzOC8wMDEzPC9yZWxhdGVkSWRlbnRpZmllcj4NCgkJPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IklzTmV3VmVyc2lvbk9mIj4xMC41NDM4LzAwMTA8L3JlbGF0ZWRJZGVudGlmaWVyPg0KCTwvcmVsYXRlZElkZW50aWZpZXJzPg0KCTxzaXplcz4NCgkJPHNpemU+NDUgcGFnZXM8L3NpemU+DQoJPC9zaXplcz4NCgk8Zm9ybWF0cz4NCgkJPGZvcm1hdD5hcHBsaWNhdGlvbi9wZGY8L2Zvcm1hdD4NCgk8L2Zvcm1hdHM+DQoJPHZlcnNpb24+NC4wPC92ZXJzaW9uPg0KCTxkZXNjcmlwdGlvbnM+DQoJCTxkZXNjcmlwdGlvbiBkZXNjcmlwdGlvblR5cGU9IlRhYmxlT2ZDb250ZW50cyI+MSBJbnRyb2R1Y3Rpb248YnIvPg0KMS4xIFRoZSBEYXRhQ2l0ZSBDb25zb3J0aXVtPGJyLz4NCjEuMiBEYXRhQ2l0ZSBDb21tdW5pdHkgUGFydGljaXBhdGlvbjxici8+DQoxLjMgVGhlIE1ldGFkYXRhIFNjaGVtYTxici8+DQoxLjQgVmVyc2lvbiA0LjAgVXBkYXRlPGJyLz4NCjIgRGF0YUNpdGUgTWV0YWRhdGEgUHJvcGVydGllczxici8+DQoyLjEgT3ZlcnZpZXc8YnIvPg0KMi4yIENpdGF0aW9uPGJyLz4NCjIuMyBEYXRhQ2l0ZSBQcm9wZXJ0aWVzPGJyLz4NCjMgWE1MIEV4YW1wbGU8YnIvPg0KNCBYTUwgU2NoZW1hPGJyLz4NCjUgT3RoZXIgRGF0YUNpdGUgU2VydmljZXM8YnIvPg0KQXBwZW5kaWNlczxici8+DQpBcHBlbmRpeCAxOiBDb250cm9sbGVkIExpc3QgRGVmaW5pdGlvbnM8YnIvPg0KQXBwZW5kaXggMjogRWFybGllciBWZXJzaW9uIFVwZGF0ZSBOb3RlczwvZGVzY3JpcHRpb24+DQoJPC9kZXNjcmlwdGlvbnM+DQo8L3Jlc291cmNlPg0K"
    },
    "relationships": {
      "publisher": {
        "meta": {}
      },
      "member": {
        "meta": {}
      },
      "registration-agency": {
        "meta": {}
      },
      "resource-type": {
        "meta": {}
      },
      "work-type": {
        "meta": {}
      }
    }
  }
}
Suggest Edits

List Works

Returns a list of works (datasets, text documents, etc.) with associated metadata.

 
gethttps://api.datacite.org/works

Query Params

rows
int32
offset
int32
sort
string

.can be deposited, published, updated or score

order
string

can be asc or desc

include
string

comma-separated list from data-center, member and resource-type

curl https://api.datacite.org/works
A binary file was returned

You couldn't be authenticated

{
  "data": [
    {
      "id": "https://doi.org/10.15468/DL.XALEJ0",
      "type": "works",
      "attributes": {
        "doi": "10.15468/DL.XALEJ0",
        "url": null,
        "author": [
          {
            "literal": "Occdownload Gbif.Org"
          }
        ],
        "title": "GBIF Occurrence Download",
        "container-title": "The Global Biodiversity Information Facility",
        "description": "A dataset containing 61 species occurrences available in GBIF matching the query: TaxonKey: Abarema racemiflora (Donn.Sm.) Barneby & J.W.Grimes. The dataset includes 61 records from 13 constituent datasets: \n 1 records from IAC - Herbário do Instituto Agronômico de Campinas. \n 13 records from Plantae of Costa Rica (INBio). \n 20 records from Tropicos Specimen Data. \n 1 records from Natural History Museum (London) Collection Specimens. \n 2 records from Natural History Museum, Vienna - Herbarium W. \n 6 records from herbario. \n 3 records from Harvard University Herbaria. \n 1 records from Field Museum of Natural History (Botany)  Seed Plant Collection. \n 3 records from The vascular plants collection (P) at the Herbarium of the Muséum national d'Histoire Naturelle (MNHN - Paris). \n 2 records from Royal Botanic Gardens, Kew - Herbarium Specimens. \n 6 records from The New York Botanical Garden Herbarium (NY) - Vascular Plant Collection. \n 1 records from Gothenburg Herbarium - General (GBIF:IH:GB:Herbarium). \n 2 records from Geneva Herbarium – General Collection (G). Data from some individual datasets included in this download may be licensed under less restrictive terms.",
        "resource-type-subtype": null,
        "publisher-id": "dk.gbif",
        "member-id": "dk",
        "registration-agency-id": "datacite",
        "resource-type-id": "dataset",
        "work-type-id": "dataset",
        "version": null,
        "license": "https://creativecommons.org/licenses/by/4.0/",
        "schema-version": "3",
        "results": [],
        "published": "2017",
        "deposited": "2017-01-04T01:57:04Z",
        "updated": "2017-01-04T01:57:04Z",
        "media": null,
        "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyI/Pgo8cmVzb3VyY2UgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vZGF0YWNpdGUub3JnL3NjaGVtYS9rZXJuZWwtMyBodHRwOi8vc2NoZW1hLmRhdGFjaXRlLm9yZy9tZXRhL2tlcm5lbC0zL21ldGFkYXRhLnhzZCIgeG1sbnM9Imh0dHA6Ly9kYXRhY2l0ZS5vcmcvc2NoZW1hL2tlcm5lbC0zIiB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIj4KICAgIDxpZGVudGlmaWVyIGlkZW50aWZpZXJUeXBlPSJET0kiPjEwLjE1NDY4L2RsLnhhbGVqMDwvaWRlbnRpZmllcj4KICAgIDxjcmVhdG9ycz4KICAgICAgICA8Y3JlYXRvcj4KICAgICAgICAgICAgPGNyZWF0b3JOYW1lPm9jY2Rvd25sb2FkIGdiaWYub3JnPC9jcmVhdG9yTmFtZT4KICAgICAgICA8L2NyZWF0b3I+CiAgICA8L2NyZWF0b3JzPgogICAgPHRpdGxlcz4KICAgICAgICA8dGl0bGU+R0JJRiBPY2N1cnJlbmNlIERvd25sb2FkPC90aXRsZT4KICAgIDwvdGl0bGVzPgogICAgPHB1Ymxpc2hlcj5UaGUgR2xvYmFsIEJpb2RpdmVyc2l0eSBJbmZvcm1hdGlvbiBGYWNpbGl0eTwvcHVibGlzaGVyPgogICAgPHB1YmxpY2F0aW9uWWVhcj4yMDE3PC9wdWJsaWNhdGlvblllYXI+CiAgICA8c3ViamVjdHM+CiAgICAgICAgPHN1YmplY3QgeG1sOmxhbmc9ImVuZyI+R0JJRjwvc3ViamVjdD4KICAgICAgICA8c3ViamVjdCB4bWw6bGFuZz0iZW5nIj5iaW9kaXZlcnNpdHk8L3N1YmplY3Q+CiAgICAgICAgPHN1YmplY3QgeG1sOmxhbmc9ImVuZyI+c3BlY2llcyBvY2N1cnJlbmNlczwvc3ViamVjdD4KICAgIDwvc3ViamVjdHM+CiAgICA8ZGF0ZXM+CiAgICAgICAgPGRhdGUgZGF0ZVR5cGU9IkNyZWF0ZWQiPjIwMTctMDEtMDQ8L2RhdGU+CiAgICAgICAgPGRhdGUgZGF0ZVR5cGU9IlVwZGF0ZWQiPjIwMTctMDEtMDQ8L2RhdGU+CiAgICA8L2RhdGVzPgogICAgPHJlc291cmNlVHlwZSByZXNvdXJjZVR5cGVHZW5lcmFsPSJEYXRhc2V0Ii8+CiAgICA8YWx0ZXJuYXRlSWRlbnRpZmllcnM+CiAgICAgICAgPGFsdGVybmF0ZUlkZW50aWZpZXIgYWx0ZXJuYXRlSWRlbnRpZmllclR5cGU9IkdCSUYiPjAwNDY5MTAtMTYwOTEwMTUwODUyMDkxPC9hbHRlcm5hdGVJZGVudGlmaWVyPgogICAgPC9hbHRlcm5hdGVJZGVudGlmaWVycz4KICAgIDxyZWxhdGVkSWRlbnRpZmllcnM+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L3c0OHBpaTwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L3Rnbm84YTwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L2hqYTY5ZjwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjU1MTkvMDAwMjk2NTwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4LzVzbDdzaDwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L3lodmJqODwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L28zcHZuaDwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L254bnF6ZjwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L25jNnJ4eTwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L2x5NjBieDwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4LzZlOG5qZTwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L2Fma2ZwaTwvcmVsYXRlZElkZW50aWZpZXI+CiAgICAgICAgPHJlbGF0ZWRJZGVudGlmaWVyIHJlbGF0ZWRJZGVudGlmaWVyVHlwZT0iRE9JIiByZWxhdGlvblR5cGU9IlJlZmVyZW5jZXMiPjEwLjE1NDY4L3J2amR1MTwvcmVsYXRlZElkZW50aWZpZXI+CiAgICA8L3JlbGF0ZWRJZGVudGlmaWVycz4KICAgIDxzaXplcz4KICAgICAgICA8c2l6ZT42NDQ5PC9zaXplPgogICAgPC9zaXplcz4KICAgIDxmb3JtYXRzPgogICAgICAgIDxmb3JtYXQ+RGFyd2luIENvcmUgQXJjaGl2ZTwvZm9ybWF0PgogICAgPC9mb3JtYXRzPgogICAgPHJpZ2h0c0xpc3Q+CiAgICAgICAgPHJpZ2h0cyByaWdodHNVUkk9Imh0dHA6Ly9jcmVhdGl2ZWNvbW1vbnMub3JnL2xpY2Vuc2VzL2J5LzQuMC9sZWdhbGNvZGUiPkNyZWF0aXZlIENvbW1vbnMgQXR0cmlidXRpb24gKENDLUJZKSA0LjA8L3JpZ2h0cz4KICAgIDwvcmlnaHRzTGlzdD4KICAgIDxkZXNjcmlwdGlvbnM+CiAgICAgICAgPGRlc2NyaXB0aW9uIGRlc2NyaXB0aW9uVHlwZT0iQWJzdHJhY3QiIHhtbDpsYW5nPSJlbmciPkEgZGF0YXNldCBjb250YWluaW5nIDYxIHNwZWNpZXMgb2NjdXJyZW5jZXMgYXZhaWxhYmxlIGluIEdCSUYgbWF0Y2hpbmcgdGhlIHF1ZXJ5OiBUYXhvbktleTogQWJhcmVtYSByYWNlbWlmbG9yYSAoRG9ubi5TbS4pIEJhcm5lYnkgJmFtcDsgSi5XLkdyaW1lcy4gVGhlIGRhdGFzZXQgaW5jbHVkZXMgNjEgcmVjb3JkcyBmcm9tIDEzIGNvbnN0aXR1ZW50IGRhdGFzZXRzOiAKIDEgcmVjb3JkcyBmcm9tIElBQyAtIEhlcmLDoXJpbyBkbyBJbnN0aXR1dG8gQWdyb27DtG1pY28gZGUgQ2FtcGluYXMuIAogMTMgcmVjb3JkcyBmcm9tIFBsYW50YWUgb2YgQ29zdGEgUmljYSAoSU5CaW8pLiAKIDIwIHJlY29yZHMgZnJvbSBUcm9waWNvcyBTcGVjaW1lbiBEYXRhLiAKIDEgcmVjb3JkcyBmcm9tIE5hdHVyYWwgSGlzdG9yeSBNdXNldW0gKExvbmRvbikgQ29sbGVjdGlvbiBTcGVjaW1lbnMuIAogMiByZWNvcmRzIGZyb20gTmF0dXJhbCBIaXN0b3J5IE11c2V1bSwgVmllbm5hIC0gSGVyYmFyaXVtIFcuIAogNiByZWNvcmRzIGZyb20gaGVyYmFyaW8uIAogMyByZWNvcmRzIGZyb20gSGFydmFyZCBVbml2ZXJzaXR5IEhlcmJhcmlhLiAKIDEgcmVjb3JkcyBmcm9tIEZpZWxkIE11c2V1bSBvZiBOYXR1cmFsIEhpc3RvcnkgKEJvdGFueSkgIFNlZWQgUGxhbnQgQ29sbGVjdGlvbi4gCiAzIHJlY29yZHMgZnJvbSBUaGUgdmFzY3VsYXIgcGxhbnRzIGNvbGxlY3Rpb24gKFApIGF0IHRoZSBIZXJiYXJpdW0gb2YgdGhlIE11c8OpdW0gbmF0aW9uYWwgZCdIaXN0b2lyZSBOYXR1cmVsbGUgKE1OSE4gLSBQYXJpcykuIAogMiByZWNvcmRzIGZyb20gUm95YWwgQm90YW5pYyBHYXJkZW5zLCBLZXcgLSBIZXJiYXJpdW0gU3BlY2ltZW5zLiAKIDYgcmVjb3JkcyBmcm9tIFRoZSBOZXcgWW9yayBCb3RhbmljYWwgR2FyZGVuIEhlcmJhcml1bSAoTlkpIC0gVmFzY3VsYXIgUGxhbnQgQ29sbGVjdGlvbi4gCiAxIHJlY29yZHMgZnJvbSBHb3RoZW5idXJnIEhlcmJhcml1bSAtIEdlbmVyYWwgKEdCSUY6SUg6R0I6SGVyYmFyaXVtKS4gCiAyIHJlY29yZHMgZnJvbSBHZW5ldmEgSGVyYmFyaXVtIOKAkyBHZW5lcmFsIENvbGxlY3Rpb24gKEcpLiBEYXRhIGZyb20gc29tZSBpbmRpdmlkdWFsIGRhdGFzZXRzIGluY2x1ZGVkIGluIHRoaXMgZG93bmxvYWQgbWF5IGJlIGxpY2Vuc2VkIHVuZGVyIGxlc3MgcmVzdHJpY3RpdmUgdGVybXMuPC9kZXNjcmlwdGlvbj4KICAgIDwvZGVzY3JpcHRpb25zPgo8L3Jlc291cmNlPgo="
      },
      "relationships": {
        "publisher": {
          "meta": {}
        },
        "member": {
          "meta": {}
        },
        "registration-agency": {
          "meta": {}
        },
        "resource-type": {
          "meta": {}
        },
        "work-type": {
          "meta": {}
        }
      }
    },
    {
      "id": "https://doi.org/10.6084/M9.FIGSHARE.4007775.V3",
      "type": "works",
      "attributes": {
        "doi": "10.6084/M9.FIGSHARE.4007775.V3",
        "url": null,
        "author": [
          {
            "family": "Matthis",
            "given": "Jonathan"
          }
        ],
        "title": "Biomechanics Center of Mass Animations [VIDEO COLLECTION]",
        "container-title": "Figshare",
        "description": "Repository of a bunch of biomechanics gifs I made. <br><br>More information (including methods and analysis) at the following links: <br><br>Handstand - http://imgur.com/k9ryJq7<div><br></div><div>Balance beam - http://imgur.com/a/lbARg</div><div><br></div><div>Ballerina -http://imgur.com/a/kskuw</div><div><br></div><div>Hammer Throw - http://imgur.com/a/h1DPc<br><br><br>____________________________________<br>More info on me here - <a href=\"https://utexas.academia.edu/JonMatthis/Papers\" target=\"_blank\">https://utexas.academia.edu/JonMatthis/Papers</a></div><div><br></div>",
        "resource-type-subtype": "Media",
        "publisher-id": "figshare.ars",
        "member-id": "figshare",
        "registration-agency-id": "datacite",
        "resource-type-id": "audiovisual",
        "work-type-id": "motion-picture",
        "version": null,
        "license": "https://creativecommons.org/publicdomain/zero/1.0/",
        "schema-version": "3",
        "results": [],
        "published": "2017",
        "deposited": "2017-01-04T01:56:40Z",
        "updated": "2017-01-04T01:56:40Z",
        "media": null,
        "xml": "PHJlc291cmNlIHhtbG5zPSJodHRwOi8vZGF0YWNpdGUub3JnL3NjaGVtYS9rZXJuZWwtMyIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vZGF0YWNpdGUub3JnL3NjaGVtYS9rZXJuZWwtMyBodHRwOi8vc2NoZW1hLmRhdGFjaXRlLm9yZy9tZXRhL2tlcm5lbC0zL21ldGFkYXRhLnhzZCI+PGlkZW50aWZpZXIgaWRlbnRpZmllclR5cGU9IkRPSSI+MTAuNjA4NC9tOS5maWdzaGFyZS40MDA3Nzc1LnYzPC9pZGVudGlmaWVyPjxjcmVhdG9ycz48Y3JlYXRvcj48Y3JlYXRvck5hbWU+Sm9uYXRoYW4gTWF0dGhpczwvY3JlYXRvck5hbWU+PC9jcmVhdG9yPjwvY3JlYXRvcnM+PHRpdGxlcz48dGl0bGU+QmlvbWVjaGFuaWNzIENlbnRlciBvZiBNYXNzIEFuaW1hdGlvbnMgW1ZJREVPIENPTExFQ1RJT05dPC90aXRsZT48L3RpdGxlcz48ZGVzY3JpcHRpb25zPjxkZXNjcmlwdGlvbiBkZXNjcmlwdGlvblR5cGU9IkFic3RyYWN0Ij5SZXBvc2l0b3J5IG9mIGEgYnVuY2ggb2YgYmlvbWVjaGFuaWNzIGdpZnMgSSBtYWRlLsKgJmx0O2JyJmd0OyZsdDticiZndDtNb3JlIGluZm9ybWF0aW9uIChpbmNsdWRpbmcgbWV0aG9kcyBhbmQgYW5hbHlzaXMpIGF0IHRoZSBmb2xsb3dpbmcgbGlua3M6wqAmbHQ7YnImZ3Q7Jmx0O2JyJmd0O0hhbmRzdGFuZCAtIGh0dHA6Ly9pbWd1ci5jb20vazlyeUpxNyZsdDtkaXYmZ3Q7Jmx0O2JyJmd0OyZsdDsvZGl2Jmd0OyZsdDtkaXYmZ3Q7QmFsYW5jZSBiZWFtIC3CoGh0dHA6Ly9pbWd1ci5jb20vYS9sYkFSZyZsdDsvZGl2Jmd0OyZsdDtkaXYmZ3Q7Jmx0O2JyJmd0OyZsdDsvZGl2Jmd0OyZsdDtkaXYmZ3Q7QmFsbGVyaW5hIC1odHRwOi8vaW1ndXIuY29tL2Eva3NrdXcmbHQ7L2RpdiZndDsmbHQ7ZGl2Jmd0OyZsdDticiZndDsmbHQ7L2RpdiZndDsmbHQ7ZGl2Jmd0O0hhbW1lciBUaHJvdyAtwqBodHRwOi8vaW1ndXIuY29tL2EvaDFEUGMmbHQ7YnImZ3Q7Jmx0O2JyJmd0OyZsdDticiZndDtfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18mbHQ7YnImZ3Q7TW9yZSBpbmZvIG9uIG1lIGhlcmUgLcKgJmx0O2EgaHJlZj0iaHR0cHM6Ly91dGV4YXMuYWNhZGVtaWEuZWR1L0pvbk1hdHRoaXMvUGFwZXJzIiB0YXJnZXQ9Il9ibGFuayImZ3Q7aHR0cHM6Ly91dGV4YXMuYWNhZGVtaWEuZWR1L0pvbk1hdHRoaXMvUGFwZXJzJmx0Oy9hJmd0OyZsdDsvZGl2Jmd0OyZsdDtkaXYmZ3Q7Jmx0O2JyJmd0OyZsdDsvZGl2Jmd0OzwvZGVzY3JpcHRpb24+PC9kZXNjcmlwdGlvbnM+PHN1YmplY3RzPjxzdWJqZWN0IHNjaGVtZVVSST0iaHR0cDovL3d3dy5hYnMuZ292LmF1L2F1c3N0YXRzL2Fic0AubnNmLzAvNkJCNDI3QUI5Njk2QzIyNUNBMjU3NDE4MDAwNDQ2M0UiIHN1YmplY3RTY2hlbWU9IkZPUiI+MTEwNjAxIEJpb21lY2hhbmljczwvc3ViamVjdD48c3ViamVjdCBzY2hlbWVVUkk9Imh0dHA6Ly93d3cuYWJzLmdvdi5hdS9hdXNzdGF0cy9hYnNALm5zZi8wLzZCQjQyN0FCOTY5NkMyMjVDQTI1NzQxODAwMDQ0NjNFIiBzdWJqZWN0U2NoZW1lPSJGT1IiPjExMDYwMyBNb3RvciBDb250cm9sPC9zdWJqZWN0PjxzdWJqZWN0IHNjaGVtZVVSST0iaHR0cDovL3d3dy5hYnMuZ292LmF1L2F1c3N0YXRzL2Fic0AubnNmLzAvNkJCNDI3QUI5Njk2QzIyNUNBMjU3NDE4MDAwNDQ2M0UiIHN1YmplY3RTY2hlbWU9IkZPUiI+MTEwNjk5IEh1bWFuIE1vdmVtZW50IGFuZCBTcG9ydHMgU2NpZW5jZSBub3QgZWxzZXdoZXJlIGNsYXNzaWZpZWQ8L3N1YmplY3Q+PC9zdWJqZWN0cz48cHVibGlzaGVyPkZpZ3NoYXJlPC9wdWJsaXNoZXI+PHB1YmxpY2F0aW9uWWVhcj4yMDE3PC9wdWJsaWNhdGlvblllYXI+PGRhdGVzPjxkYXRlIGRhdGVUeXBlPSJDcmVhdGVkIj4yMDE3LTAxLTA0PC9kYXRlPjxkYXRlIGRhdGVUeXBlPSJVcGRhdGVkIj4yMDE3LTAxLTA0PC9kYXRlPjwvZGF0ZXM+PHJlc291cmNlVHlwZSByZXNvdXJjZVR5cGVHZW5lcmFsPSJBdWRpb3Zpc3VhbCI+TWVkaWE8L3Jlc291cmNlVHlwZT48c2l6ZXM+PHNpemU+NjcwMTY3NDQgQnl0ZXM8L3NpemU+PC9zaXplcz48cmVsYXRlZElkZW50aWZpZXJzPjxyZWxhdGVkSWRlbnRpZmllciByZWxhdGVkSWRlbnRpZmllclR5cGU9IkRPSSIgcmVsYXRpb25UeXBlPSJJc0lkZW50aWNhbFRvIj4xMC42MDg0L205LmZpZ3NoYXJlLjQwMDc3NzU8L3JlbGF0ZWRJZGVudGlmaWVyPjwvcmVsYXRlZElkZW50aWZpZXJzPjxyaWdodHNMaXN0PjxyaWdodHMgcmlnaHRzVVJJPSJodHRwczovL2NyZWF0aXZlY29tbW9ucy5vcmcvcHVibGljZG9tYWluL3plcm8vMS4wLyI+Q0MtMDwvcmlnaHRzPjwvcmlnaHRzTGlzdD48L3Jlc291cmNlPg=="
      },
      "relationships": {
        "publisher": {
          "meta": {}
        },
        "member": {
          "meta": {}
        },
        "registration-agency": {
          "meta": {}
        },
        "resource-type": {
          "meta": {}
        },
        "work-type": {
          "meta": {}
        }
      }
    },
    {
      "id": "https://doi.org/10.13140/RG.2.2.17768.88326",
      "type": "works",
      "attributes": {
        "doi": "10.13140/RG.2.2.17768.88326",
        "url": null,
        "author": [
          {
            "family": "Valenzuela-Rendón",
            "given": "Manuel"
          }
        ],
        "title": "vgGA2.0 (Octave/MATLAB)",
        "container-title": "Unpublished",
        "description": null,
        "resource-type-subtype": "Code",
        "publisher-id": "rg.rg",
        "member-id": "rg",
        "registration-agency-id": "datacite",
        "resource-type-id": "dataset",
        "work-type-id": "dataset",
        "version": null,
        "license": null,
        "schema-version": "4",
        "results": [],
        "published": "2017",
        "deposited": "2017-01-04T01:53:30Z",
        "updated": "2017-01-04T01:53:30Z",
        "media": null,
        "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyI/PjxyZXNvdXJjZSB4c2k6c2NoZW1hTG9jYXRpb249Imh0dHA6Ly9kYXRhY2l0ZS5vcmcvc2NoZW1hL2tlcm5lbC00IGh0dHA6Ly9zY2hlbWEuZGF0YWNpdGUub3JnL21ldGEva2VybmVsLTQvbWV0YWRhdGEueHNkIiB4bWxucz0iaHR0cDovL2RhdGFjaXRlLm9yZy9zY2hlbWEva2VybmVsLTQiIHhtbG5zOnhzaT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEtaW5zdGFuY2UiPjxpZGVudGlmaWVyIGlkZW50aWZpZXJUeXBlPSJET0kiPjEwLjEzMTQwL1JHLjIuMi4xNzc2OC44ODMyNjwvaWRlbnRpZmllcj48Y3JlYXRvcnM+PGNyZWF0b3I+PGNyZWF0b3JOYW1lPk1hbnVlbCBWYWxlbnp1ZWxhLVJlbmTDs248L2NyZWF0b3JOYW1lPjwvY3JlYXRvcj48L2NyZWF0b3JzPjx0aXRsZXM+PHRpdGxlPnZnR0EyLjAgKE9jdGF2ZS9NQVRMQUIpPC90aXRsZT48L3RpdGxlcz48cHVibGlzaGVyPlVucHVibGlzaGVkPC9wdWJsaXNoZXI+PHB1YmxpY2F0aW9uWWVhcj4yMDE3PC9wdWJsaWNhdGlvblllYXI+PHJlc291cmNlVHlwZSByZXNvdXJjZVR5cGVHZW5lcmFsPSJEYXRhc2V0Ij5Db2RlPC9yZXNvdXJjZVR5cGU+PC9yZXNvdXJjZT4="
      },
      "relationships": {
        "publisher": {
          "meta": {}
        },
        "member": {
          "meta": {}
        },
        "registration-agency": {
          "meta": {}
        },
        "resource-type": {
          "meta": {}
        },
        "work-type": {
          "meta": {}
        }
      }
    }
  ],
  "meta": {
    "resource-types": [
      {
        "id": "dataset",
        "title": "Dataset",
        "count": 2923633
      },
      {
        "id": "text",
        "title": "Text",
        "count": 1588230
      },
      {
        "id": "other",
        "title": "Other",
        "count": 882665
      },
      {
        "id": "image",
        "title": "Image",
        "count": 833098
      },
      {
        "id": "collection",
        "title": "Collection",
        "count": 381883
      },
      {
        "id": "software",
        "title": "Software",
        "count": 20790
      },
      {
        "id": "audiovisual",
        "title": "Audiovisual",
        "count": 14110
      },
      {
        "id": "event",
        "title": "Event",
        "count": 6932
      },
      {
        "id": "physical-object",
        "title": "Physical object",
        "count": 6679
      },
      {
        "id": "film",
        "title": "Film",
        "count": 947
      },
      {
        "id": "model",
        "title": "Model",
        "count": 604
      },
      {
        "id": "interactive-resource",
        "title": "Interactive resource",
        "count": 407
      },
      {
        "id": "sound",
        "title": "Sound",
        "count": 344
      },
      {
        "id": "workflow",
        "title": "Workflow",
        "count": 252
      },
      {
        "id": "service",
        "title": "Service",
        "count": 29
      }
    ],
    "years": [
      {
        "id": "2016",
        "title": "2016",
        "count": 834677
      },
      {
        "id": "2015",
        "title": "2015",
        "count": 2080251
      },
      {
        "id": "2014",
        "title": "2014",
        "count": 973996
      },
      {
        "id": "2013",
        "title": "2013",
        "count": 353263
      },
      {
        "id": "2012",
        "title": "2012",
        "count": 232386
      },
      {
        "id": "2011",
        "title": "2011",
        "count": 353464
      },
      {
        "id": "2010",
        "title": "2010",
        "count": 159988
      },
      {
        "id": "2009",
        "title": "2009",
        "count": 144549
      },
      {
        "id": "2008",
        "title": "2008",
        "count": 138810
      },
      {
        "id": "2007",
        "title": "2007",
        "count": 170651
      },
      {
        "id": "2006",
        "title": "2006",
        "count": 155580
      },
      {
        "id": "2005",
        "title": "2005",
        "count": 168750
      },
      {
        "id": "2004",
        "title": "2004",
        "count": 86246
      },
      {
        "id": "2003",
        "title": "2003",
        "count": 80393
      },
      {
        "id": "2002",
        "title": "2002",
        "count": 52403
      }
    ],
    "publishers": [
      {
        "id": "cdl.dplanet",
        "title": "Data-Planet",
        "count": 867774
      },
      {
        "id": "bl.ccdc",
        "title": "The Cambridge Crystallographic Data Centre",
        "count": 639461
      },
      {
        "id": "figshare.ars",
        "title": "figshare Academic Research System",
        "count": 527635
      },
      {
        "id": "ethz.seals",
        "title": "E-Periodica",
        "count": 513892
      },
      {
        "id": "estdoi.bio",
        "title": "TÜ Loodusmuuseum",
        "count": 487449
      },
      {
        "id": "rg.rg",
        "title": "ResearchGate",
        "count": 428070
      },
      {
        "id": "gesis.die",
        "title": "Deutsches Institut für Erwachsenenbildung",
        "count": 373193
      },
      {
        "id": "ethz.epics-ba",
        "title": "E-Pics Bildarchiv",
        "count": 361242
      },
      {
        "id": "tib.pangaea",
        "title": "PANGAEA - Publishing Network for Geoscientific and Environmental Data",
        "count": 351387
      },
      {
        "id": "dk.gbif",
        "title": "Global Biodiversity Information Facility",
        "count": 243978
      },
      {
        "id": "cern.hepdata",
        "title": "HEPData.net",
        "count": 236059
      },
      {
        "id": "cisti.ubc",
        "title": "University of British Columbia",
        "count": 198206
      },
      {
        "id": "bl.imperial",
        "title": "Imperial College London",
        "count": 191300
      },
      {
        "id": "ands.centre72",
        "title": "PARADISEC",
        "count": 153467
      },
      {
        "id": "cern.zenodo",
        "title": "ZENODO - Research. Shared.",
        "count": 116167
      }
    ],
    "schema-versions": [
      {
        "id": "4",
        "title": "Schema 4",
        "count": 108228
      },
      {
        "id": "3",
        "title": "Schema 3",
        "count": 6662751
      },
      {
        "id": "2.2",
        "title": "Schema 2.2",
        "count": 1070998
      },
      {
        "id": "2.1",
        "title": "Schema 2.1",
        "count": 5700
      },
      {
        "id": "2.0",
        "title": "Schema 2.0",
        "count": 756
      }
    ],
    "total": 7848433,
    "sources": [],
    "relation-types": []
  }
}
{
  "errors": [
    {
      "status": "404",
      "title": "The page you are looking for doesn't exist."
    }
  ]
}
 

Version History

  • v.2: September 1, 2011

Overview

The MDS (Metadata Store) API can me use to register and manage DOI names and associated metadata. The API requires authentication and is available to DataCite members and their data centers. The basic API endpoint is at https://mds.datacite.org, with the following three resource endpoints:

  • https://mds.datacite.org/doi
  • https://mds.datacite.org/metadata
  • https://mds.datacite.org/media

Authentication

All requests to the MDS API require authentication. For this reason, only traffic via a secure connection (HTTPS) is supported. The DataCite Metadata Store (MDS) uses HTTP Basic authentication.

To start interacting with our DataCite Metadata Store (MDS) API you must request an account:

  • If you are a DataCite Member, DataCite will provide you a username and password
  • If you are a DataCite User, your Allocating Member will provide you a username and password
  • If you are not yet a DataCite Member or User, you can obtain test credentials to our sandbox

Remember our accounts have basic security constraints:

  • you will be allowed to register DOI names only under the prefixes that have been assigned to you
  • your DOI names can only refer to URLs under host domains you control
  • depending on your Allocating Member, you may or may not have an unlimited number of DOIs available. You can negotiate your quota with your Allocating Member

API Response Codes

  • 200 OK - operation successful
  • 201 OK - content created
  • 204 No Content - DOI is known to MDS, but is not registered (or not resolvable e.g. due to handle’s latency)
  • 401 Unauthorized - no login
  • 403 - login problem or DOI belongs to another party
  • 404 Not Found - DOI does not exist in our database
  • 500 Internal Server Error - server internal error, try later and if problem persists please contact us

Testing

There are three ways you can test the MDS without registering a permanent DOI:

Use the test MDS

The test MDS at https://mds.test.datacite.org is available to all members and users. DOIs registered in the test MDS will not resolve using the doi.org proxy.

Use the testMode query parameter

Each API call can have an optional testMode query parameter. If set to “true” or “1”, e.g. POST /doi?testMode=true, the request will not change the database nor will the DOI handle be registered or updated.

Use the test prefix 10.5072

The special test prefix 10.5072 is available to all data centers. Please use it for all your testing DOIs. Note that DOIs with test prefix will behave like any other DOI, e.g. they can be normally resolved. They will not be exposed in services like search and OAI, though.

Your own prefixes should not be used for testing DOIs in the production MDS service.

Suggest Edits

Get URL for DOI

This request returns an URL associated with a given DOI.

 

Basic Auth

 Authentication is required for this endpoint.
gethttps://mds.test.datacite.org/doi/doi

Path Params

doi
string
required
curl https://mds.test.datacite.org/doi/10.5438/0012
cirneco doi get 10.5438/0012 --sandbox
A binary file was returned

You couldn't be authenticated

https://schema.datacite.org/meta/kernel-4.0/index.html
An Authentication object was not found in the SecurityContext
DOI not found
Suggest Edits

List all DOIs

This request returns a list of all DOIs for the requesting datacentre. There is no guaranteed order.

 

Basic Auth

 Authentication is required for this endpoint.
gethttps://mds.test.datacite.org/doi
curl https://mds.test.datacite.org/doi
cirneco doi get all --sandbox
A binary file was returned

You couldn't be authenticated

10.23725/0000-03VC
10.23725/0000-0A53
10.23725/GQZDGNZW
Suggest Edits

Create DOI

Will mint new DOI if specified DOI doesn’t exist. This method will attempt to update URL if you specify an existing DOI. Standard domains and quota restrictions check will be performed. A data centers's doiQuotaUsed will be increased by 1.

 

Basic Auth

 Authentication is required for this endpoint.
puthttps://mds.test.datacite.org/doi

Form Data

doi
string
url
string

Headers

Content-Type
string
required
charset
string
required

Short explanation of status code e.g. CREATED, HANDLE_ALREADY_EXISTS etc

curl --data doi=10.5072/0000-03VC\nurl=http://www.datacite.org https://mds.test.datacite.org/doi/10.5072/0000-03VC
cirneco doi put 10.5438/0012 --url https://schema.datacite.org/meta/kernel-4.0/index.html --sandbox
A binary file was returned

You couldn't be authenticated

Suggest Edits

Get Metadata for DOI

This request returns the most recent version of metadata associated with a given DOI.

 

Basic Auth

 Authentication is required for this endpoint.
gethttps://mds.test.datacite.org/metadata/doi

Path Params

doi
string
required

Headers

Accept
string
required
curl https://mds.test.datacite.org/metadata/10.5072/0000-03VC
cirneco metadata get 10.5072/0000-03VC
A binary file was returned

You couldn't be authenticated

<?xml version="1.0" encoding="UTF-8"?>
<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://datacite.org/schema/kernel-4" xsi:schemaLocation="http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4/metadata.xsd">
  <identifier identifierType="DOI">10.5072/0000-03VC</identifier>
  <creators>
    <creator>
      <creatorName>Miller, Elizabeth</creatorName>
      <givenName>Elizabeth</givenName>
      <familyName>Miller</familyName>
      <nameIdentifier schemeURI="http://orcid.org/" nameIdentifierScheme="ORCID">0000-0001-5000-0007</nameIdentifier>
    </creator>
  </creators>
  <titles>
    <title>Full DataCite XML Example</title>
  </titles>
  <publisher>DataCite</publisher>
  <publicationYear>2014</publicationYear>
  <resourceType resourceTypeGeneral="Software">XML</resourceType>
  <dates/>
</resource>
Suggest Edits

Create Metadata for DOI

This request stores a new version of metadata. The request body must contain valid XML.
short explanation of status code e.g. CREATED, HANDLE_ALREADY_EXISTS etc

 

Basic Auth

 Authentication is required for this endpoint.
posthttps://mds.test.datacite.org/metadata/

Headers

Content-Type
string
required
charset
string
required
curl -data 10.5072/0000-03VC.xml https://mds.test.datacite.org/metadata
cirneno metadata post 10.5072/0000-03VC.xml --sandbox
A binary file was returned

You couldn't be authenticated

OK (10.5072/0000-03VC)
Suggest Edits

Delete Metadata for DOI

This request marks a dataset as inactive. To activate it again, POST new metadata or set the is active flag in the user interface.

 

Basic Auth

 Authentication is required for this endpoint.
deletehttps://mds.test.datacite.org/metadata/doi

Path Params

doi
string
required
curl -X DELETE https://mds.test.datacite.org/metadata/10.5072/0000-03VC
cirneco metadata delete 10.5072/0000-03VC --sandbox
A binary file was returned

You couldn't be authenticated

Suggest Edits

Get Media for DOI

This request returns list of pairs of media type and URLs associated with a given DOI.

 

Basic Auth

 Authentication is required for this endpoint.
gethttps://mds.test.datacite.org/media/doi

Path Params

doi
string
required

Headers

head
string
curl https://mds.test.datacite.org/media/10.5072/0000-03VC
cirneco media get 10.5072/0000-03VC --sandbox
A binary file was returned

You couldn't be authenticated

application/pdf=http://www.datacite.org/cirneco-test.pdf
Suggest Edits

Create Media for DOI

POST will add/update media type/URLs pairs to a DOI. Standard domain restrictions check will be performed.

 

Basic Auth

 Authentication is required for this endpoint.
posthttps://mds.test.datacite.org/media/doi

Path Params

doi
string
required

Headers

Content-Type
string
required
charset
string
required
curl --data "application/pdf=http://www.datacite.org/cirneco-test.pdf" http://mds.datacite.org/media/10.5072/0000-03VC
cirneco media post 10.5072/0000-03VC.txt --sandbox
A binary file was returned

You couldn't be authenticated