orcid_employments: Get employment information for a person

View source: R/orcid_employments.R

orcid_employmentsR Documentation

Get employment information for a person

Description

Get employment information for a person

Usage

orcid_employments(
  orcid,
  put_code = NULL,
  format = "application/json",
  summary = FALSE,
  ...
)

Arguments

orcid

(character) Orcid identifier(s), of the form XXXX-XXXX-XXXX-XXXX. required.

put_code

(character/integer) one or more put codes. up to 50. optional

format

(character) Name of the content-type format. One of "application/vnd.orcid+xml; qs=5", "application/orcid+xml; qs=3", "application/xml", "application/vnd.orcid+json; qs=4", "application/orcid+json; qs=2", "application/json" "application/vnd.citationstyles.csl+json". optional

summary

(logical) get employment summary for a put code. Default: FALSE

...

Curl options passed on to crul::HttpClient()

Details

This function is vectorized, so you can pass in many ORCID's, and there's an element returned for each ORCID you put in.

Value

A list of results for each Orcid ID passed in, with each element named by the Orcid ID

Examples

## Not run: 
# all employment data
res <- orcid_employments(orcid = "0000-0002-1642-628X")
res$`0000-0002-1642-628X`
names(res$`0000-0002-1642-628X`)
res$`0000-0002-1642-628X`$`employment-summary`

# individual employment records
orcid_employments(orcid = "0000-0002-1642-628X", 1115445)
orcid_employments(orcid = "0000-0002-1642-628X", 148496)

# employment summary information
orcid_employments(orcid = "0000-0002-1642-628X", 1115445, summary = TRUE)

## End(Not run)

ropensci/rorcid documentation built on Sept. 12, 2022, 2:09 p.m.