For what the Citation Checker does and when to use it, see the Citation Checker concept page. This guide will walk you through submitting a scan with the citation checker turned on, reading the summary from the completed webhook, and fetching the full per-reference results.

How it works

Each detected reference is sorted into one of two categories, and each category is validated differently: A reference is counted as validated only when the top suggestion matches the title and no checked field contradicts it. Fields that could not be checked are simply ignored - they do not count against the reference.

Get started

1

Before you begin

Before you start, ensure you have the following:
2

Installation

Choose your preferred method for making API calls.
HTTP needs no installation - call the API with any standard HTTP client, or import our Postman collection for a quicker start.
3

Login

To perform a scan, we first need to generate an access token. For that, we will use the login endpoint. The API key can be found on the Copyleaks API Dashboard.Upon successful authentication, you will receive a token that must be attached to subsequent API calls via the Authorization: Bearer <TOKEN> header. This token remains valid for 48 hours.
Response
Save this token. It is valid for 48 hours and can be reused for subsequent API calls.
4

Submit a scan with the citation checker

Submit a document for scanning and turn the citation checker on. Use the top-level properties.references.validate field and set it to true.If you omit the section entirely, validation defaults to false.This example also disables internet plagiarism scanning (scanning.internet: false) so the scan runs references-only.
Keep track of the scanId (in this case my-scan-id). You will need it to fetch the full per-reference results once the scan completes.
5

Read the summary from the completed webhook

When the scan finishes, Copyleaks sends the completed webhook to the status URL you provided. The payload reports that validation ran via scannedDocument.enabled.referencesValidation, and adds a top-level referencesValidation.summary with the counts.
Completed webhook (excerpt)
The summary fields are:
  • total - total references detected in the document.
  • academic - how many of those were academic.
  • academicValidated - academic references that were fully corroborated.
  • nonAcademicValidated - non-academic references that were fully corroborated.
The completed webhook carries the summary only. To see each individual reference, what was parsed, and which sources corroborated it, fetch the crawled version in the next step.
6

Fetch the per-reference results

The completed webhook gives you the summary only. The full per-reference results live in the crawled version of the scan.Retrieve it with the Export method, using the scanId from your submission. The exported crawled version contains a top-level referencesValidation block: the same summary plus a results array with one entry per reference.For the full field-by-field response schema, including how a reference counts as validated and the strict year matching rule, see the Citation Checker results data type.
7

Summary

You have just:
  • Submitted a scan with the citation checker turned on via references.validate
  • Read the validation counts from the completed webhook summary
  • Fetched the crawled version to inspect each parsed reference and its corroborating sources

Next steps

How the Citation Checker Works

Understand the concepts behind reference detection, parsing, and corroboration before you build.

Citation Checker Results

The full field reference for the summary and per-reference results, including signals and suggestions.

Detect AI-Generated Content

Run AI detection on uploaded documents as part of a full authenticity scan.

Check for Plagiarism

Submit text or files and get a plagiarism report with matched sources.