Skip to main content
GET
/
certificates
/
{type}
/
{id}
Get certificate by id.
curl --request GET \
  --url https://lab.trustos.telefonicatech.com/cert/v2/certificates/{type}/{id} \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 200,
  "message": "Certificate found",
  "data": {
    "certID": "did:local:certid:123124",
    "data": {
      "name": "Certificate",
      "description": "Certificate description",
      "type": "content",
      "content": {},
      "issuer": "did:user:{issuer}",
      "issuedOn": 1696840286580,
      "hash": "a2ac9343a3d94e41bbc5c152fb8382c5233a47cee23cf765c7e6d67d9e61a142",
      "expires": 1696840286580
    },
    "metadata": [
      {
        "type": "Evidence",
        "networkId": 10004,
        "smartContract": "0xabcdbcbff5fa05e060e7dfe3e608cba010d11abc",
        "transactionHash": "0xabcdbcbff5fa05e060e7dfe3e608cba010d11abc",
        "trustPointHash": "a2ac9343a3d94e41bbc5c152fb8382c5233a47cee23cf765c7e6d67d9e61a142",
        "timestamp": 1696840286580
      }
    ],
    "access": {
      "public": true,
      "certificatePin": "1234",
      "externalId": "extcertid"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
type
enum<string>
required

Type of the certificate identifier.

Available options:
certID,
externalId,
fileHash,
hash
​
id
string
required

Identifier of the certificate.

Example:

"123"

Query Parameters

​
pin
string

PIN of the certificate (if the certificate is private).

Example:

"1234"

Response

Successful certificate retrieval.

​
statusCode
integer

Request status code.

Example:

200

​
message
string

Message returned by the request.

Example:

"Certificate found"

​
data
object

Data returned by the request.