# getScholarlyWork

**Identifier:** `lens_getScholarlyWork`

**Provider:** [Lens](https://kirha.com/providers/lens.md)

Retrieve the full record of one scholarly work by Lens ID, DOI, PMID or PMCID: abstract, authors with affiliations, journal, open access, MeSH terms, funding, clinical trials, retractions and citation counts. Returns the Lens IDs of patents citing it (usable with getPatent or searchPatents lensIds). Scholarly Lens IDs come from searchScholarlyWorks or getPatent citedScholarlyLensIds. Use getScholarlyCitations for citing works and the full reference list.

## Run it with the CLI

```bash
kirha tools run lens_getScholarlyWork \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "lens_getScholarlyWork",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "doi": {
      "description": "e.g., 10.1126/science.1225829",
      "type": "string"
    },
    "lensId": {
      "description": "Scholarly Lens ID, e.g., 064-908-811-700-011",
      "type": "string"
    },
    "pmcid": {
      "description": "e.g., PMC6286148",
      "type": "string"
    },
    "pmid": {
      "description": "e.g., 22745249",
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "abstract": {
      "type": "string"
    },
    "authorCount": {
      "type": "number"
    },
    "authors": {
      "description": "First 100",
      "items": {
        "additionalProperties": false,
        "properties": {
          "affiliations": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "country": {
                  "type": "string"
                },
                "institution": {
                  "type": "string"
                },
                "rorId": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          },
          "orcid": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "chemicals": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "citationCount": {
      "description": "Scholarly works citing this one",
      "type": "number"
    },
    "citingPatentLensIds": {
      "description": "Patent Lens IDs citing this work, first 100, for getPatent or searchPatents lensIds; use getScholarlyCitations for all",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "clinicalTrials": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "registry": {
            "type": "string"
          },
          "trialId": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "conference": {
      "type": "string"
    },
    "context": {
      "type": "string"
    },
    "datePublished": {
      "type": "string"
    },
    "doi": {
      "type": "string"
    },
    "fieldsOfStudy": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "funding": {
      "description": "First 50",
      "items": {
        "additionalProperties": false,
        "properties": {
          "country": {
            "type": "string"
          },
          "funder": {
            "type": "string"
          },
          "grantId": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "issns": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "issue": {
      "type": "string"
    },
    "journal": {
      "type": "string"
    },
    "keywords": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "languages": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "lensId": {
      "type": "string"
    },
    "meshTerms": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "openAccessColour": {
      "type": "string"
    },
    "openAccessLicense": {
      "type": "string"
    },
    "openAccessUrl": {
      "type": "string"
    },
    "openAlexId": {
      "type": "string"
    },
    "pages": {
      "type": "string"
    },
    "patentCitationCount": {
      "description": "Patents citing this work",
      "type": "number"
    },
    "pmcid": {
      "type": "string"
    },
    "pmid": {
      "type": "string"
    },
    "publicationType": {
      "type": "string"
    },
    "publisher": {
      "type": "string"
    },
    "publisherCountry": {
      "type": "string"
    },
    "referenceCount": {
      "type": "number"
    },
    "referenceLensIds": {
      "description": "Scholarly Lens IDs of cited works, first 100; use getScholarlyCitations for all",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "retractionUpdates": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "date": {
            "type": "string"
          },
          "nature": {
            "type": "string"
          },
          "reasons": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "sourceType": {
      "type": "string"
    },
    "subjects": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "supplementaryTypes": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "title": {
      "type": "string"
    },
    "volume": {
      "type": "string"
    }
  },
  "required": [
    "context"
  ],
  "type": "object"
}
```

## Related tools

Other Lens tools that this tool refers to, or that refer to it.

- [`searchPatents`](https://kirha.com/providers/lens/searchPatents.md)
- [`getPatentCitations`](https://kirha.com/providers/lens/getPatentCitations.md)
- [`searchScholarlyWorks`](https://kirha.com/providers/lens/searchScholarlyWorks.md)
- [`getPatent`](https://kirha.com/providers/lens/getPatent.md)
- [`getScholarlyCitations`](https://kirha.com/providers/lens/getScholarlyCitations.md)

-----

[All Lens tools](https://kirha.com/providers/lens.md) · [< Back to tools list](https://kirha.com/tools.md)