Retrieve provenance of a diamond through the certificate number

GET {{baseUrl}}/provenances?asset.certificateNo=5343346340&asset.certifier=GIA&x-evl-version=2

This request will fetch the provenance tree of an asset like diamond from certificate number from certifiers like GIA. Features of this API call are below: 1) It will return an array of events from the manufacturing of the diamond. The sequence of this is typically invoice -> allotting -> assessing -> planning -> cutting -> polishing ->reviewing->grading 2) The set of events can vary by supplier and sometimes from one diamond to another, however, the nomenclature and schema will be normalized. You can use the content of the createdAt field to order the events. 3) As well as the events, this endpoint also returns the media attachments for each event. The url to each of these points to the object on our Google Cloud Storage bucket, and is valid for 2 hours from the time it is generated by calling the endpoint for this asset.

Request Params

Key	Datatype	Description
`asset.certificateNo`	number	(Required) Unique asset identifier
`asset.certifier`	string	(Required) Unique asset identifier
`x-evl-version`	number

HEADERS

Key	Datatype	Required	Description
`x-evl-client-id`	string		(Required) Client Id to be passed here
`Accept`	string

RESPONSES

status: OK

[{&quot;header&quot;:{&quot;eventId&quot;:&quot;string&quot;,&quot;inputs&quot;:[&quot;string&quot;],&quot;eventType&quot;:&quot;origin&quot;,&quot;actionType&quot;:&quot;diamond:kpc&quot;,&quot;sourceList&quot;:[{&quot;id&quot;:&quot;string&quot;,&quot;interestType&quot;:&quot;string&quot;}],&quot;destList&quot;:[{&quot;id&quot;:&quot;string&quot;,&quot;interestType&quot;:&quot;string&quot;}],&quot;timeFrame&quot;:{&quot;beganAt&quot;:&quot;2020-10-26T21:10:23Z&quot;,&quot;finishedAt&quot;:&quot;2020-10-26T21:10:23Z&quot;,&quot;start_at&quot;:&quot;2020-10-26T21:10:23Z&quot;,&quot;end_at&quot;:&quot;2020-10-26T21:10:23Z&quot;},&quot;createdAt&quot;:&quot;2020-10-26T21:10:23Z&quot;,&quot;location&quot;:{&quot;placeName&quot;:&quot;string&quot;,&quot;latitude&quot;:0,&quot;longitude&quot;:0}},&quot;elements&quot;:{},&quot;attachment&quot;:[{&quot;id&quot;:&quot;string&quot;,&quot;key&quot;:&quot;string&quot;,&quot;url&quot;:&quot;string&quot;,&quot;mimeType&quot;:&quot;string&quot;,&quot;appType&quot;:&quot;diamond:kpc-image&quot;,&quot;indexNo&quot;:0}]}]