authorship-object.md

Authorship object

The Authorship object represents a single author and her institutional affiliations in the context of a given work. It is only found as part of a Work object, in the work.authorships property.

author

String: An author of this work, as a dehydrated Author object.

Note that, sometimes, we assign ORCID using author disambiguation, so the ORCID we associate with an author was not necessarily included with this work.

author: {
    id: "https://openalex.org/A5085171399",
    display_name: "Juan Pablo Alperin",
    orcid: "https://orcid.org/0000-0002-9344-7439"
}

author_position

String: A summarized description of this author's position in the work's author list. Possible values are first, middle, and last.

It's not strictly necessary, because author order is already implicitly recorded by the list order of Authorship objects; however it's useful in some contexts to have this as a categorical value.

author_position: "first"

countries

List: The country or countries for this author.

We determine the countries using a combination of matched institutions and parsing of the raw affiliation strings, so we can have this information for some authors even if we do not have a specific institutional affiliation.

countries: [
    "US"
]

institutions

List: The institutional affiliations this author claimed in the context of this work, as dehydrated Institution objects.

institutions: [
    {
        id: "https://openalex.org/I18014758",
        display_name: "Simon Fraser University",
        ror: "https://ror.org/0213rcc28",
        country_code: "CA",
        type: "education",
        lineage: ["https://openalex.org/I18014758"]
    }
]

is_corresponding

Boolean: If true, this is a corresponding author for this work.

{% hint style="warning" %} This is a new feature, and the information may be missing for many works. We are working on this, and coverage will improve soon. {% endhint %}

raw_affiliation_string

String: This author's affiliation as it originally came to us (on a webpage or in an API), as a raw unformatted string. Multiple affiliations are separated by a semicolon.

raw_affiliation_string: "Canadian Institute for Studies in Publishing, Simon Fraser University,

raw_author_name

String: This author's name as it originally came to us (on a webpage or in an API), as a raw unformatted string.

raw_author_name: "Juan Pablo Alperin"