Get Certified Docs

Retrieving Chamber approved CO Application

Once the CO application is approved by the Chambers, it is available for retrieval by the client. Based on a valid Authentication token and Application Id, the DTO API responds with a Certificate URL in PDF. Please note that while we refer to the DTO APIs, the APIs work for both DTO and essCert.. Here is how a usual request looks.

cURL

curl --location --request GET 'https://api.tradecert2.net/api/v1/cert/CO/2151917/issue' \
--header 'Authorization: Bearer eyJraWQiOiJDeHBweFAycjhtSm5xRnVicjVQQm5QU2RoWmFtK1JpakJkcU9CNTlGVVwvdz0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJhYzA1ZTk2MS1hZWI2LTQ5NTMtOTVjNy02NjMwOGFmNTQ2ODAiLCJldmVudF9pZCI6IjhjYWQ3NjVkLWM0YTYtNGE0My1iNjMxLTdmOGUxYzM0ODFiMiIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3RpbWUiOjE2Mzg5MDA0ODAsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC5ldS13ZXN0LTEuYW1hem9uYXdzLmNvbVwvZXUtd2VzdC0xXzVkUWhLMWxqSCIsImV4cCI6MTYzODkwNDA4MCwiaWF0IjoxNjM4OTAwNDgwLCJqdGkiOiI0NzZhNzllNS00MWNlLTQxOTItYjE4Zi1iZTlkZmZmMGE3NmMiLCJjbGllbnRfaWQiOiIxdWxmdnUycDhhZnN2Z2VwcGdrOXNiMDExcCIsInVzZXJuYW1lIjoiam9obmF1c2NsaWVudCJ9.A9k7T3b3sNTODR5ZOCxarNJaQrtw4W7qV4XD4Tg1WQyyid6cX-A9aLMaadvMUlVbtCTNtjihspZxnIrgfaSfSD_T2TktS8bmI2MArwkHMa-V2v_WJyMJeuP-mBVPkRMb7y7CRjx_TGQkYElnFKcFSbT6fBskFL9h3Pmx1gIsuTpwc2v38KHQP6DgcfSp-o2c16ncNiaYMipTAw_4mTn9I_bhA4iG-zALdJt_1fbzOyJ9L2g1EV_VzqWS8tT8f5qs2jhwui6P2opes0Zn823QcmxQ_rXPby9sO9c9n78FjDsQZ7Iyxt-wEopPpU3h08Fy5bdAsq6_8wLBqNj5MCGy_w' \
--header 'Content-Type: application/json'

A valid 200 OK against this request looks like below.

JSON

{
    "id": "2151917",
    "certUrl": "https://s3.eu-west-1.amazonaws.com/com.tradecert2.uploads/attachments/2021/Dec/2151917/IssuedCert_2151917_2021-12-04_00-21-18-252748.pdf?AWSAccessKeyId=ASIAQGBZ4R5LJSANWFQG&Expires=1638900618&Signature=mxJ8VEY7J1xeqM1GXjdiLwET6PM%3D&x-amz-security-token=IQoJb3JpZ2luX2VjENL%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCWV1LXdlc3QtMSJHMEUCIQD%2B3fkPfnvLcfgpF8zkx59LVLJJtb3KBn6jOcKLfzneIgIgbQ73EY1urPKFEt7zNBeEKDCu2%2FY4UOuWKhlKYwBrSbAqxgIIq%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgwwMTMwMDYzMTEyNTQiDCx8FtgWXESbEJ3QqiqaAsiz4Hlc7J9YwoZhTY1s%2Fr9pQHLJ0PGJyQVDIzv%2BPvkkQWJEwiyzFNvlIaPKoiDVYpqi%2Bjq6Tk9bPJiPsITAKOu8NO3I8FO%2B%2FyMGdYM5fm3Gi0ZTBm2mh09o%2FJZY4uu9zvyAm27y%2BOedcaoUShDi7oeqRZBZeXU3O49xdef5kBCFXM2L4n%2FApeDhJFR5X3U0sm9BCVvrsn4EAbeKqY0PUX7r3000YBAzuQA0NZG1sX8RPqP09bOvJEOWetRcU4nc%2Bj5WHkPBKWHCJDFVy%2FA3LBT9UQOiOVaCA2Hz9CLtGrCriAWPUeaWwany2wjkiFt%2FcrGrm04Uy%2BUGpMxOeLpo3yd48QBAVFagZpT%2FBVJQsxIXnSnP9Cg%2FcbSTaTCPxr6NBjqaAaUz34xfnIIvLx%2F1GxpyhPwbseXuEkObRracJz%2BjbcfX11MoVXIgIGkzeAm5YejJAq6MeHT061RuwEuyGBwXncUBzBEiqJFoZr5Rk%2FIUG%2Fc4HTOBDFmPSSDJkGIriu%2FuOiXgE1EuEKp%2Bn%2BoqLfP9BHlXNlCr3rhqPxnZ03OyRCXsUyUJawShAcEJl1S4Rlm8uGRepWkvgxwwLUs%3D",
    "combinedAttachments": "null",
    "attachments": []
}

The certUrl provides a link to the PDF which is an official Chamber-approved CO application based on the submitted data. Here is how a usual CO Certificate looks like.

🚧

Error Response

Standard error responses like 4xx or 5xx are identified through the response header with a message returned in the body having additional details from the essCert API.

e.g. A 403 Forbidden will have the below response body.

{
"Message": "Access Denied"
}

❗️

Expired certUrl Link

The certUrl link gets expired after 120 seconds. However, the PDF can be downloaded as many times as required before the link gets expired.