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.

affiliations

List: List of objects

Each institutional affiliation that this author has claimed will be listed here: the raw affiliation string that we found, along with the OpenAlex Institution ID or IDs that we matched it to.

This information will be redundant with institutions below, but is useful if you need to know about what we used to match institutions.

affiliations: [
    {
        raw_affiliation_string: "Scholarly Communications Lab, Simon Fraser University, Vancouver, Canada",
        institution_ids: [
            "https://openalex.org/I18014758"
        ]
    }
]

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_strings

List: This author's affiliation as it originally came to us (on a webpage or in an API), as a list of raw unformatted strings. If there is only one affiliation, it will be a list of length one.

raw_affiliation_strings: [
    "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"