Java Client for the OriginStamp service
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

OriginStamp Java Client

Build Status

A Java implementation of the OriginStamp API. For endpoint documentation see OriginStamp Documentation

Table of Contents


Official releases

You can use this project by downloading the .zip file from one of the releases.

Maven, Gradle, SBT

Package managers are supported through JitPack which supports Maven, Gradle, SBT, etc.

For Maven, add the following sections to your pom.xml (replacing $LATEST_VERSION):



Building the API client library requires Maven to be installed.

  • Clone this repository
  • Add the maven dependency
  • mvn clean install

OriginStamp can be used to prove the existence of a record at a specific point in time. The resulting timestamps can be used, for example, to secure supply chains, prove damage, simplify regulatory compliance, and prove the authorship of data, such as photos. Originally launched in 2011 as a research project to protect researchers ideas, OriginStamp has now become a commercial product and the leading platform for blockchain-based timestamps due to the ever-increasing demand.

Getting Started

Please follow the installation instruction and execute the following Java code:

// Import classes:
//import com.originstamp.api.client.ApiException;
//import com.originstamp.api.TimestampApi;

TimestampApi apiInstance = new TimestampApi();
String authorization = "authorization_example"; // String | A valid API key is essential for authorization to handle the request.
TimestampRequest timestampRequest = new TimestampRequest(); // TimestampRequest | DTO for the hash submission. Add all relevant information concerning your hash submission.
try {
    DefaultTimestampResponse result = apiInstance.createTimestamp(authorization, timestampRequest);
} catch (ApiException e) {
    System.err.println("Exception when calling TimestampApi#createTimestamp");

Documentation for API Endpoints

All URIs are relative to

Class Method HTTP request Description
SchedulerApi getNextSchedulingTime POST /v3/submission/times NextSchedule
TimestampApi createTimestamp POST /v3/timestamp/create Submission
TimestampApi getApiKeyUsage GET /v3/api_key/usage Usage
TimestampApi getHashStatus GET /v3/timestamp/{hash_string} Status
TimestampApi getProof POST /v3/timestamp/proof Proof
TimestampApi triggerTimestampWebhook POST /v3/webhook/start Dev

Documentation for Models

Documentation for Authorization

Authentication schemes defined for the API:

Key Authorization

  • Type: API key
  • API key parameter name: Authorization
  • Location: HTTP header


It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.