TradeTrust API

Verify endpoint#

Currently there is an API endpoint for verifying documents issued on ropsten network at: https://verify-ropsten.tradetrust.io. However it is recommended that you setup your own, refer to the guide on how.

Axios example#

axios.post("https://verify-ropsten.tradetrust.io", ISSUED_DOCUMENT)

Example usage:

axios
  .post("https://verify-ropsten.tradetrust.io", ISSUED_DOCUMENT)
  .then(function (response) {
    console.log(response.data.summary); // should return { all: true, documentStatus: true, documentIntegrity: true, issuerIdentity: true }
  })
  .catch(function (error) {
    console.log(error);
  });

Curl example#

curl --location 'https://verify-ropsten.tradetrust.io' --request POST --data 'ISSUED_DOCUMENT'

Return response of a verified document:

{
   "summary":{
      "all":true,
      "documentStatus":true,
      "documentIntegrity":true,
      "issuerIdentity":true
   },
   "data":[
      {
         "type":"DOCUMENT_INTEGRITY",
         "name":"OpenAttestationHash",
         "data":true,
         "status":"VALID"
      },
      {
         "status":"SKIPPED",
         "type":"DOCUMENT_STATUS",
         "name":"OpenAttestationEthereumDocumentStoreIssued",
         "reason":{
            "code":4,
            "codeString":"SKIPPED",
            "message":"Document issuers doesn't have \"documentStore\" or \"certificateStore\" property or DOCUMENT_STORE method"
         }
      },
      {
         "name":"OpenAttestationEthereumTokenRegistryMinted",
         "type":"DOCUMENT_STATUS",
         "data":{
            "mintedOnAll":true,
            "details":[
               {
                  "minted":true,
                  "address":"0x13249BA1Ec6B957Eb35D34D7b9fE5D91dF225B5B"
               }
            ]
         },
         "status":"VALID"
      },
      {
         "status":"SKIPPED",
         "type":"DOCUMENT_STATUS",
         "name":"OpenAttestationEthereumDocumentStoreRevoked",
         "reason":{
            "code":4,
            "codeString":"SKIPPED",
            "message":"Document issuers doesn't have \"documentStore\" or \"certificateStore\" property or DOCUMENT_STORE method"
         }
      },
      {
         "name":"OpenAttestationDnsTxt",
         "type":"ISSUER_IDENTITY",
         "data":[
            {
               "status":"VALID",
               "location":"demo-tradetrust.openattestation.com",
               "value":"0x13249BA1Ec6B957Eb35D34D7b9fE5D91dF225B5B"
            }
         ],
         "status":"VALID"
      }
   ]
}

Remember to replace ISSUED_DOCUMENT with your own document json object in the above examples.