Documentation

XML deposit using HTTPS POST

XML files can be POSTed to our system where they are added to the submission queue to await processing. You can do this yourself or make use of our java program.

On this page, find out more about:

Submitting files - an overview

Uploading files (for deposit or for bulk queries) are submitted using HTTPS POST with the encType: multipart/form-data. The URL for all submissions is https://doi.crossref.org/servlet/deposit. You may also POST submissions to our test system using https://test.crossref.org/servlet/deposit. Learn more about our test system.

The following parameters are supported:

Form fieldDescriptionPossible valuesMandatory?Default
operationDepends on submission typedoMDUpload: For metadata (XSD) submissions (or, (full XML) metadata upload)
doDOICitUpload: For DOI citations or resources submissions (or, (resource-only) DOI resources)
doQueryUpload: For query submissions
doDOIQueryUpload: For DOI-to-metadata query submissions
doTransferDOIsUpload: For submissions to update resource resolution URLs
NodoMDUpload
subTypesubtype for metadata submissionscm: for conflict management submissionsNoNot applicable
login_idCrossref account credentials usernameIf using shared role credentials, add the role. If using personal user credentials, add your email address and the role in this format email@address.com/role. The login_id value is case sensitiveYesNot applicable
login_passwdCrossref account credentials passwordthe login_passwd value is case sensitiveYesNot applicable
Content parts
fnameSubmission contentsthe fname value is case sensitiveYesNot applicable

Sample transactions

Sample transaction using curl

curl -F 'operation=doQueryUpload' -F 'login_id=[username]' -F 'login_passwd=[password]' -F 'fname=@[filename]' https:// doi.crossref.org/servlet/deposit

Note: several members have contacted us about use of the @ in the above sample transaction; it should be retained prior to the filename

Sample https transaction

POST https://doi-crossref-org/servlet/deposit?operation=doMDUpload&login_id=[username]&login_passwd=[password] HTTP/1.1
Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, */*
Accept-Language: en-us
Content-Type: multipart/form-data; boundary=---------------------------7d22911b10028e
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; Q312461)
Host: Myhost
Content-length: 1304 Pragma: no-cache -----------------------------7d22911b10028e
Content-Disposition: form-data; name="fname"; filename="crossref_query.xml"
<?xml version="1.0" encoding="UTF-8"?>
<doi_batch version="4.3.0" xmlns="http://www.crossref.org/schema/4.3.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.crossref.org/schema/4.3.0 http://www.crossref.org/schemas/crossref4.3.0.xsd">
<head>
...
</head>
<body>
<journal>
....
</journal>
</body>
</doi_batch>
-----------------------------7d22911b10028e--

For backward compatibility, we also accept the login_id, login_passwd, operation, and area parameters in a multi-part request:

-----------------------------7d22911b10028e
Content-Disposition: form-data; name="login_id"
atypon
-----------------------------7d22911b10028e
Content-Disposition: form-data; name="login_passwd"
_atypon_
-----------------------------7d22911b10028e
Content-Disposition: form-data; name="fname"; filename="hisham.xml"

... file contents ...

Submission limits

We have a limit of 10,000 pending submissions per user. If there are 10,000 submissions in our queue for a given user, subsequent uploads will fail with a 429 error. You may resume POSTing when pending submissions are below 10,000.

Page owner: Isaac Farley   |   Last updated 2024-January-22