The Crossref Curriculum

Retrieving identifiers for deposited references

Including a content item’s references as a citation list in the item’s metadata is encouraged, and is essential for participating in our Cited-by service. During the deposit process, these references are matched and the resulting DOIs are returned in the deposit log.

References that do not match at the time of deposit will be remembered internally and periodically re-run. These subsequent attempts to match references contribute to Cited-by data. The member who deposited the article containing these references can use the following API call to retrieve an updated list of the article’s matched references:

https://doi.crossref.org/getResolvedRefs?doi=*DOI*&usr=*username*&pwd=*password*

Note that the account (username and password) used in the query must have permission to view references for the deposited DOI.

Examples of retrieving identifiers for references

The key returned in the matches is the same key supplied for the corresponding citation in the reference deposit. These results contain both journal articles and a book series:

{
	doi: "10.1103/PhysRevE.91.062714",
	matched-references: [
		{
			key: "PhysRevE.91.062714Cc1R1",
			doi: "10.1038/nature01609",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc2R1",
			doi: "10.1016/S0301-4622(02)00177-1",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc3R1",
			doi: "10.1073/pnas.1214051110",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc4R1",
			doi: "10.1529/biophysj.106.093062",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc5R1",
			doi: "10.1073/pnas.1833310100",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc6R1",
			doi: "10.1073/pnas.0802484105",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc7R1",
			doi: "10.1021/jz301537t",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc8R1",
			doi: "10.1103/PhysRevX.2.031012",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc9R1",
			doi: "10.1016/j.bpj.2011.03.067",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc10R1",
			doi: "10.1529/biophysj.104.045344",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc11R1",
			doi: "10.1021/ja970640a",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc12R1",
			doi: "10.1073/pnas.0509011103",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc13R1",
			doi: "10.1126/science.1057886",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc14R1",
			doi: "10.1103/PhysRevA.18.255",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc15R1",
			doi: "10.1103/PhysRevE.89.012144",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc16R1",
			doi: "10.1140/epje/e2003-00019-8",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc17R1",
			doi: "10.1021/jp061840o",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc18R1",
			doi: "10.1021/jp073413w",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc20R1",
			doi: "10.1142/2012",
			type: "book_title"
		},
		{
			key: "PhysRevE.91.062714Cc23R1",
			doi: "10.1103/PhysRev.91.1505",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc24R1",
			doi: "10.1039/b918607g",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc25R1",
			doi: "10.1021/jp311028e",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc26R1",
			doi: "10.1016/S0006-3495(03)74892-9",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc27R1",
			doi: "10.1209/epl/i2003-10158-3",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc28R1",
			doi: "10.1016/j.physa.2004.12.005",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc29R1",
			doi: "10.1529/biophysj.106.094052",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc30R1",
			doi: "10.1529/biophysj.106.094243",
			type: "journal_article"
		},
		{
			key: "PhysRevE.91.062714Cc31R1",
			doi: "10.1007/978-3-642-61544-3",
			type: "book_title"
		}
	]
}

These results contain a match made to a DataCite DOI (via reg-agency):

{
	doi: "10.50505/doi_2006042312",
	matched-references: [
		{
			key: "ref1",
			doi: "10.50505/test_20051231320",
			type: "journal_article"
		},
		{
			key: "ref2",
			doi: "10.50505/test_200611161351",
			type: "journal_article"
		},
		{
			key: "ref3",
			doi: "10.5167/UZH-29884",
			reg-agency: "DataCite"
		}
	]
}

Last Updated: 2020 April 8 by Laura J. Wilkinson