Get DataCite work
datacite_get_workRead-onlyIdempotent
Fetch the full deposited DataCite metadata for one DOI: titles, creators and contributors with ORCID iDs and ROR affiliations, publisher, dates, version, subjects, descriptions, funding, geolocations, rights, sizes and formats, related identifiers with their relation types, repository and provider, and citation, reference, version, part, view, and download counts. Long lists are capped with their full counts reported; use datacite_trace_relations for the complete relation graph. A DOI DataCite does not hold returns found: false naming the registration agency that does, or saying the DOI does not exist.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | Yes | The DOI, e.g. 10.5061/dryad.234: 10., a 4–9 digit registrant, a slash, and a suffix. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | No | The DOI, normalized to lowercase bare form. | |
| dates | No | Dates. Found arm only. | |
| error | No | Present when the call failed. Absent on success. | |
| found | No | True when DataCite holds a public record for the DOI. | |
| sizes | No | Sizes as deposited, e.g. "2123413 bytes". Found arm only. | |
| counts | No | DataCite's own counts; they can trail the live record by a few events. Found arm only. | |
| doiUrl | No | Resolver URL, https://doi.org/<doi>, with #, ?, and % percent-encoded. Found arm only. | |
| rights | No | The work's own rights and licenses — distinct from metadataLicense. Found arm only. | |
| titles | No | Every title, main title first. Found arm only. | |
| created | No | When the record was created. Found arm only. | |
| formats | No | Formats as deposited. Found arm only. | |
| updated | No | When the record was last updated. Found arm only. | |
| version | No | Version string. Found arm only. | |
| creators | No | Creators, capped at 100 (full count in truncatedLists). Found arm only. | |
| guidance | No | The next step for this miss. Miss arm only. | |
| language | No | Language as deposited, usually an ISO 639-1 code such as en. Found arm only. | |
| subjects | No | Subjects, capped at 100 (full count in truncatedLists). Found arm only. | |
| publisher | No | Publisher. Found arm only. | |
| landingUrl | No | The repository's landing page. Found arm only. | |
| missReason | No | Why DataCite holds no public record: another agency registered it, no agency did, it is a DataCite DOI without public (Findable) metadata, or the agency lookup did not answer. Miss arm only. | |
| registered | No | When the DOI was registered. Found arm only. | |
| repository | No | The DataCite repository that registered the DOI. Found arm only. | |
| contentUrls | No | Direct content URLs, when deposited. Found arm only. | |
| contributors | No | Contributors, capped at 100 (full count in truncatedLists). Found arm only. | |
| descriptions | No | Descriptions. Found arm only. | |
| geoLocations | No | Geolocations, capped at 50 (full count in truncatedLists). Found arm only. | |
| relatedItems | No | Related items described inline in this record — typically the journal, book, or series it appears in — capped at 25 (full count in truncatedLists). Found arm only. | |
| resourceType | No | Free-text resource type the depositor gave. Found arm only. | |
| schemaVersion | No | DataCite metadata schema version URI. Found arm only. | |
| truncatedLists | No | Lists the caps bound, with their full counts. Present only when a cap bound. | |
| metadataLicense | No | License of the DataCite metadata itself (CC0 1.0), not of the work it describes. Found arm only. | |
| publicationYear | No | Publication year. Found arm only. | |
| fundingReferences | No | Funding, capped at 100 (full count in truncatedLists). Found arm only. | |
| registrationAgency | No | Registration agency that holds the DOI (e.g. Crossref, mEDRA, DataCite), when known. Miss arm only. | |
| relatedIdentifiers | No | Related identifiers, capped at 100 (full counts in relatedIdentifierCounts). Found arm only. | |
| resourceTypeGeneral | No | resourceTypeGeneral, e.g. Dataset or Software. Found arm only. | |
| alternateIdentifiers | No | Alternate identifiers. Found arm only. | |
| relatedIdentifierCounts | No | relationType → full count of related identifiers, before the cap. Found arm only. |