API error codes

Below is a list of error codes generated by the DataCite APIs and few hints to help with debugging.

Common Issues

  • Wrong endpoint - check if the endpoint is for test or production
  • Bad credentials - always use a repository account to register DOIs
  • Incorrectly formatted metadata - (see DataCite Metadata Schema for required fields and API reference for fields supported in JSON

Error codes and possible solutions

Error code


Possible Solution


Bad Request

Check the docs again and try to reproduce.


Bad credentials.

Unauthorized - Check your password.


You are not authorized to access this resource.

Forbidden - Check your password or validate that you are updating a DOI/prefix/repository you have permissions for.


The resource you are looking for doesn't exist.

Not Found - The resource is not found e.g. it fetching a DOI/Repository/Member details.


Method Not Allowed

The http method on the request made is not supported. Check documentation.


Unprocessable Entity

Check the contents of your request, the system understood but it was unable to process it. For a DOI update this might be invalid URL or metadata is invalid.


Internal Server Error

Try to reproduce and report steps that caused it.


Bad Gateway

Most likely a temporary issue, try again


Service Unavailable

Check our status page status.datacite.org.


Gateway Timeout

Check our status page/releases status.datacite.org.

Did this page help you?