> ## Documentation Index > Fetch the complete documentation index at: https://docs.scite.ai/llms.txt > Use this file to discover all available pages before exploring further. # Receive citations with the DOI as a source paper > Get citations made from a given DOI. Note that the citation statements are excluded from the output. Can also return relevant paper metadata and tallies for citation sources. This endpoint requires an API token with special access. For more information, please contact us at sales@scite.ai ## OpenAPI ````yaml /openapi.json get /api_partner/citations/cited_by/{doi} openapi: 3.1.0 info: title: Scite API description: >- The Scite API provides publication metadata, Smart Citation tallies, citation graphs, literature search, paper recommendations, collections, Reference Check, Assistant, Evidence datasets, and MCP access. Use the **Documentation** tab for task-oriented guides and the **API Reference** tab for endpoint schemas and parameters. ## Authentication Papers and Tallies endpoints are public. Most other endpoints require a bearer credential: ``` Authorization: Bearer ``` Pro users can create and manage keys in the [API Console](https://scite.ai/users/me/api). Available scopes depend on the account. Enterprise credentials, higher limits, and additional scopes are available through [sales](https://scite.ai/contact). See **Authentication** in the Documentation tab for the access matrix, and **Errors and rate limits** for recovery guidance. Use of the API is subject to the [Scite Terms of Use](https://scite.ai/terms). version: latest x-logo: url: https://cdn.scite.ai/assets/images/logo-blue.svg license: name: Scite Terms of Use url: https://scite.ai/terms servers: - url: https://api.scite.ai description: Production security: - BearerAuth: [] tags: - name: Search description: >- Search metadata and citation statements in Scite. Using the Search API for commercial or research use requires a separate license agreement not covered by individual plans. Please email sales@scite.ai for more information. - name: Paper recommendations description: >- Return papers related to a supplied DOI. Recommendations are available for evaluation with eligible Pro access; commercial or research use requires a separate license agreement. Contact sales@scite.ai for licensing. - name: Papers description: >- Retrieve publication metadata by DOI or PMID, including title, abstract, authors, journal, identifiers, retraction status, and editorial notices. Papers endpoints are public. - name: Tallies description: >- Retrieve Smart Citation tallies by DOI. Tally counts represent citation statements; `citingPublications` represents distinct citing publications. Tallies endpoints are public. - name: Smart Citation Graph description: >- Retrieve citations at the in-text level between and from papers by DOI. For example, given a DOI, get a list of citing DOIs including the section and classification of each citation statement. Snippets are not included in the response. Note that these endpoints are restricted without an API token. - name: References description: |- Retrieve references to and from publications by DOI. Note that these endpoints require an API token for usage. - name: Journal description: |- Retrieve aggregate information about journals by ISSN. ### ISSN Format ### A valid ISSN is in the format `dddd-dddC`, where: ``` - d = any decimal digit (0-9) - C = checksum (0-9 or X) ``` - name: Authors description: Retrieve author metadata and papers by author slug. - name: Collections description: >- Create, retrieve, update, and remove collections: sets of papers monitored over time. A dashboard is a report on a collection. - name: Reference Check description: >- Schedule and retrieve reference check jobs. Note that a paid license is required for this feature (please email sales@scite.ai for more information). For an example output report: [see here](https://scite.ai/reference-check/683e0cbc-b322-4692-be6d-f5432b4a453c). - name: Assistant description: >- Ask research questions and receive answers grounded in Scite citation evidence. The Assistant API is asynchronous: 1. Submit a request with `POST /api_partner/assistant/poll` to receive a task ID. 2. Poll `GET /api_partner/assistant/tasks/{task_id}` until the task completes. Both endpoints require a bearer credential with the `assistant` scope. - name: Evidence description: >- Search patents, clinical trials, and grants via the Resolute evidence datasets. Requires an API token with a per-dataset scope (`evidence:patents:api`, `evidence:grants:api`, `evidence:clinical-trials:api`). Please email sales@scite.ai for access. ## Query parameters ### `q` — free-text query Supports boolean operators (`AND`, `OR`, `NOT`) and phrase matching with double quotes. Examples: `q=CRISPR`, `q="gene therapy" AND cancer`, `q=diabetes NOT type+1` ### `f` — field filters Space-delimited filters in `field:"value"` format. **Values must be quoted** with double quotes. Call `GET /schema` for the full list of filterable fields per dataset. **Patent filters**: `patents.filingStatus` (`"application"`, `"grant"`), `patents.assignees.name`, `patents.inventors.name`, `patents.languages` (ISO 639-1, e.g. `"en"`) **Clinical trial filters**: `trialState.phase` (`"Phase I"` .. `"Phase IV"`, `"N/A"`), `trialState.overallStatus` (`"Recruiting"`, `"Completed"`, …), `conditions`, `interventions.name`, `sponsors.name`, `registry` (`"ClinicalTrials.gov"`, `"UMIN-CTR"`, …), `design.studyType` (`"Interventional"`, `"Observational"`) **Grant filters**: `agency`, `organization`, `piName`, `country` (ISO 3166-1 alpha-3, e.g. `"USA"`, `"GBR"`), `dataSource` (`"NIH RePORTER"`, `"NSF"`, …) Example: `f=trialState.phase:"Phase III" trialState.overallStatus:"Recruiting"` **Date range filters** use `gte` (>=) and `lt` (<) suffixes with ISO dates or epoch milliseconds: `f=dates.startDategte:"2024-01-01" dates.startDatelt:"2025-01-01"`. Epoch ms: `f=dates.startDategte:"1704067200000" dates.startDatelt:"1735689600000"`. Dates without a timezone are interpreted as UTC. Timezone offsets are supported: `"2024-01-01T00:00:00+05:00"`. No space between the field name and the suffix. ### `s` — sort mode Default is `_relevance`. Call `GET /schema` to discover sortable fields per dataset. ## Response format note Some fields in search and detail responses may be either a plain string or an object `{"id": "...", "name": "..."}` (and optionally `"highlighted": "..."`), depending on the query. Consumers should handle both shapes, e.g. `value.id ?? value.name ?? value`. - name: PubMed Source Tallies description: >- Retrieve tallies indicating how many times a given paper was cited by documents of various types from PubMed (e.g. how many times was a given DOI cited by practice guidelines). paths: /api_partner/citations/cited_by/{doi}: get: tags: - Smart Citation Graph summary: Receive citations with the DOI as a source paper description: >- Get citations made from a given DOI. Note that the citation statements are excluded from the output. Can also return relevant paper metadata and tallies for citation sources. This endpoint requires an API token with special access. For more information, please contact us at sales@scite.ai operationId: getCitedByPublications parameters: - name: doi in: path required: true schema: type: string title: Doi - name: papers in: query required: false schema: type: boolean description: Also fetch source paper metadata. default: false title: Papers description: Also fetch source paper metadata. - name: tallies in: query required: false schema: type: boolean description: Also fetch source tally metadata. default: false title: Tallies description: Also fetch source tally metadata. - name: authorization in: header required: false schema: type: string description: Set to `Bearer ` to pass token for authorization. title: Authorization description: Set to `Bearer ` to pass token for authorization. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CitationsCitedByExternalSchema' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CitationsCitedByExternalSchema: properties: tallies: anyOf: - additionalProperties: $ref: '#/components/schemas/TallyDB' type: object - type: 'null' title: Tallies papers: anyOf: - additionalProperties: $ref: '#/components/schemas/PaperResponse' type: object - type: 'null' title: Papers metadata: $ref: '#/components/schemas/CitationsMetadataSchema' citations: items: $ref: '#/components/schemas/CitationsCitedByExternal' type: array title: Citations type: object required: - metadata - citations title: CitationsCitedByExternalSchema example: metadata: totalCitationCount: 1 restrictedCitationCount: 0 distinctSourceCount: 1 isApproximate: false citations: - id: 1 source: 10.1016/j.neuropsychologia.2017.03.016 target: 10.1016/j.pscychresns.2007.03.006 section: discussion type: supporting typeConfidence: 0.93 selfCites: [] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TallyDB: properties: total: type: integer title: Total supporting: type: integer title: Supporting contradicting: type: integer title: Contradicting mentioning: type: integer title: Mentioning unclassified: type: integer title: Unclassified doi: type: string title: Doi citingPublications: anyOf: - type: integer - type: 'null' title: Citingpublications type: object required: - total - supporting - contradicting - mentioning - unclassified - doi title: TallyDB example: citingPublications: 436 contradicting: 6 doi: 10.1016/j.biopsych.2005.08.012 mentioning: 308 supporting: 27 total: 347 unclassified: 6 PaperResponse: properties: id: anyOf: - type: integer - type: 'null' title: Id doi: type: string title: Doi slug: anyOf: - type: string - type: 'null' title: Slug type: anyOf: - type: string - type: 'null' title: Type title: anyOf: - type: string - type: 'null' title: Title default: Untitled abstract: anyOf: - type: string - type: 'null' title: Abstract authors: anyOf: - items: $ref: '#/components/schemas/AuthorSchema' type: array - type: 'null' title: Authors keywords: anyOf: - items: type: string type: array - type: 'null' title: Keywords year: anyOf: - type: integer - type: 'null' title: Year shortJournal: anyOf: - type: string - type: 'null' title: Shortjournal publisher: anyOf: - type: string - type: 'null' title: Publisher issue: anyOf: - type: string - type: 'null' title: Issue volume: anyOf: - type: string - type: 'null' title: Volume page: anyOf: - type: string - type: 'null' title: Page pmPublicationType: anyOf: - type: string - type: 'null' title: Pmpublicationtype retracted: anyOf: - type: boolean - type: 'null' title: Retracted memberId: anyOf: - type: integer - type: 'null' title: Memberid issns: anyOf: - items: type: string type: array - type: 'null' title: Issns tally: anyOf: - $ref: '#/components/schemas/TallyDB' - type: 'null' citingTally: anyOf: - $ref: '#/components/schemas/CitingTallySourceDB' - type: 'null' editorialNotices: items: $ref: '#/components/schemas/EditorialNoticeSchema' type: array title: Editorialnotices journalSlug: anyOf: - type: string - type: 'null' title: Journalslug journal: anyOf: - type: string - type: 'null' title: Journal preprintLinks: items: $ref: '#/components/schemas/PreprintLinkSchema' type: array title: Preprintlinks publicationLinks: items: $ref: '#/components/schemas/PublicationLinkSchema' type: array title: Publicationlinks normalizedTypes: items: type: string type: array title: Normalizedtypes type: object required: - doi title: PaperResponse example: authors: - affiliation: University of Chicago affiliationID: '17898' affiliationSlug: university-of-chicago-6096 authorID: '20073081' authorName: K. Luan Phan authorSequenceNumber: 1 authorSlug: k-luan-phan-jz0xRV family: Phan given: K. Luan - affiliation: Wayne State University affiliationID: '11741' affiliationSlug: wayne-state-university-Xje9 authorID: '14943755' authorName: Daniel A. Fitzgerald authorSequenceNumber: 2 authorSlug: daniel-a-fitzgerald-e6pg3O family: Fitzgerald given: Daniel A. - affiliation: Monash University affiliationID: '6663' affiliationSlug: monash-university-DZee authorID: '15102805' authorName: Pradeep J. Nathan authorSequenceNumber: 3 authorSlug: pradeep-j-nathan-Ax3j3L family: Nathan given: Pradeep J. - affiliation: Wayne State University affiliationID: '11741' affiliationSlug: wayne-state-university-Xje9 authorID: '3534491' authorName: Manuel Tancer authorSequenceNumber: 4 authorSlug: manuel-tancer-1O4Lj family: Tancer given: Manuel doi: 10.1016/j.biopsych.2005.08.012 editorialNotices: [] id: 66831114 issns: - 0006-3223 issue: '5' journal: Biological Psychiatry journalSlug: 5GzJD memberId: 78 normalizedTypes: - article page: 424-429 preprintLinks: [] publicationLinks: [] publisher: Elsevier BV retracted: false shortJournal: Biological Psychiatry slug: association-between-amygdala-hyperactivity-to-gVamGz title: >- Association between Amygdala Hyperactivity to Harsh Faces and Severity of Social Anxiety in Generalized Social Phobia type: journal-article volume: '59' year: 2006 CitationsMetadataSchema: properties: totalCitationCount: type: integer title: Totalcitationcount restrictedCitationCount: anyOf: - type: integer - type: 'null' title: Restrictedcitationcount distinctSourceCount: anyOf: - type: integer - type: 'null' title: Distinctsourcecount citingCounts: anyOf: - $ref: '#/components/schemas/CitationsCitingCounts' - type: 'null' isApproximate: anyOf: - type: boolean - type: 'null' title: Isapproximate maxPaginationOffset: anyOf: - type: integer - type: 'null' title: Maxpaginationoffset type: object required: - totalCitationCount title: CitationsMetadataSchema CitationsCitedByExternal: properties: id: type: integer title: Id source: type: string title: Source target: type: string title: Target snippet: anyOf: - type: string - type: 'null' title: Snippet refLocation: anyOf: - type: string - type: 'null' title: Reflocation section: anyOf: - type: string - type: 'null' title: Section expertClassification: anyOf: - type: string - type: 'null' title: Expertclassification type: anyOf: - type: string - type: 'null' title: Type typeConfidence: anyOf: - type: number - type: 'null' title: Typeconfidence selfCites: items: $ref: '#/components/schemas/SelfCiteSchema' type: array title: Selfcites type: object required: - id - source - target title: CitationsCitedByExternal ErrorResponse: type: object properties: detail: type: string description: Human-readable error detail. required: - detail title: ErrorResponse ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError AuthorSchema: properties: family: anyOf: - type: string - type: 'null' title: Family given: anyOf: - type: string - type: 'null' title: Given orcid: anyOf: - type: string - type: 'null' title: Orcid affiliation: anyOf: - type: string - type: 'null' title: Affiliation authorSlug: anyOf: - type: string - type: 'null' title: Authorslug authorName: anyOf: - type: string - type: 'null' title: Authorname authorID: anyOf: - type: string - type: 'null' title: Authorid authorLastKnownAffiliationId: anyOf: - type: integer - type: 'null' title: Authorlastknownaffiliationid authorSequenceNumber: anyOf: - type: integer - type: 'null' title: Authorsequencenumber affiliationSlug: anyOf: - type: string - type: 'null' title: Affiliationslug affiliationID: anyOf: - type: string - type: 'null' title: Affiliationid type: object title: AuthorSchema CitingTallySourceDB: properties: total: type: integer title: Total supporting: type: integer title: Supporting contradicting: type: integer title: Contradicting mentioning: type: integer title: Mentioning unclassified: type: integer title: Unclassified sourceDoi: type: string title: Sourcedoi numCitedPublications: anyOf: - type: integer - type: 'null' title: Numcitedpublications type: object required: - total - supporting - contradicting - mentioning - unclassified - sourceDoi title: CitingTallySourceDB example: total: 317 supporting: 24 contradicting: 3 mentioning: 290 unclassified: 0 sourceDoi: 10.1016/j.biopsych.2005.08.012 numCitedPublications: 377 EditorialNoticeSchema: properties: status: anyOf: - type: string - type: 'null' title: Status date: anyOf: - type: string - type: 'null' title: Date noticeDoi: anyOf: - type: string - type: 'null' title: Noticedoi doi: type: string title: Doi urls: anyOf: - items: type: string type: array - type: 'null' title: Urls type: object required: - doi title: EditorialNoticeSchema PreprintLinkSchema: properties: preprintDoi: type: string title: Preprintdoi type: object required: - preprintDoi title: PreprintLinkSchema PublicationLinkSchema: properties: publishedDoi: type: string title: Publisheddoi type: object required: - publishedDoi title: PublicationLinkSchema CitationsCitingCounts: properties: total: type: integer title: Total sections: $ref: '#/components/schemas/SectionCounts' pubTypes: additionalProperties: type: integer type: object title: Pubtypes journals: additionalProperties: type: integer type: object title: Journals relationships: $ref: '#/components/schemas/RelationshipCounts' dateHistogram: additionalProperties: additionalProperties: type: integer type: object type: object title: Datehistogram authors: additionalProperties: type: integer type: object title: Authors type: object required: - total - sections - pubTypes - journals - relationships - dateHistogram - authors title: CitationsCitingCounts SelfCiteSchema: properties: type: anyOf: - type: string - type: 'null' title: Type family: anyOf: - type: string - type: 'null' title: Family given: anyOf: - type: string - type: 'null' title: Given type: object required: - type - family - given title: SelfCiteSchema SectionCounts: properties: introduction: type: integer title: Introduction methods: type: integer title: Methods results: type: integer title: Results discussion: type: integer title: Discussion other: type: integer title: Other type: object required: - introduction - methods - results - discussion - other title: SectionCounts RelationshipCounts: properties: selfCite: type: integer title: Selfcite independent: type: integer title: Independent type: object required: - selfCite - independent title: RelationshipCounts responses: Unauthorized: description: The request is missing a valid bearer credential. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: >- The credential is valid, but the key or account lacks the required scope. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: The requested resource was not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: >- The request exceeded a rate limit. Inspect the rate-limit headers before retrying. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: The server encountered an unexpected error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API key or JWT ````