Originality API – Getting Started

What this article covers

1. When to use the Originality API
2. Base URL and environment
3. Authentication model – OAuth 2.0

When to use the Originality API

You can use the API when you need to:

• Submit documents to your institution's Originality license
• Retrieve similarity reports outside the WISEflow Marking Tool – for example, to display them in a custom learner-feedback portal
• Reschedule a document that failed processing
• Build a tool around the Originality data your institution owns

Base URL and environment

Originality API runs in one environment:

You can find our interactive Originality API documentation at https://api.wiseflow-originality.net/

Authentication model – OAuth 2.0

WISEflow Originality uses OAuth 2.0 client credentials flow. Each license can provision a client_id and client_secret and receive short-lived bearer tokens that are presented on each API call.

There is no end-user authentication on the API path — assessor and administrator sign-in lives only in the dashboard at wiseflow-originality.net.

Token lifecycle and caching

Access tokens expire after 30 minutes. Cache by (client_id, environment) and refresh proactively before expiry.