DataCite Support

DataCite Support

Welcome to DataCite's support site. Here you will find helpful information about our services. We have included comprehensive technical guides, training materials, and tips to help you successfully use DataCite services.

Get Started    API Reference

How do I make a “findable” DOI with the REST API?

DataCite DOIs can be created in three states “draft”, “registered” or “findable”. If you are using the REST API to create DOIs you need to specify the “event” attribute in the JSON payload. This corresponds to the action you want to trigger. To create a DOI in findable state, the required action is "publish". You need to make sure you include the URL and all of the required DOI metadata fields (DOI, creators, title, publisher, publicationYear, resourceTypeGeneral).

For example

"event": "publish"

Possible actions:

publish - Triggers a state move from draft or registered to findable

register - Triggers a state move from draft to registered

hide - Triggers a state move from findable to registered

We recommend incorporating draft DOIs into your workflow, they can be deleted. Findable and registered DOIs cannot be deleted.

For more information and examples see

Updated 10 months ago

How do I make a “findable” DOI with the REST API?


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.