Validate API

The Validate API allows you to check if a certificate ID you've received is valid or not. To make this request you will need an ActiveProspect account.

Making a Request

To use the Validate API service you will make a GET request to https://cert.trustedform.com/:cert_id/validate where cert_id is your certificate ID. Just like other TrustedForm services, you will need to include your API key to authenticate in the request.

curl -i -X GET \
  -u <username>:<password> \
  'https://cert.trustedform.com/{cert_id}/validate' \
  -H 'Content-Type: application/json'

Responses

Success response are returned if the certificate ID is valid. Failure responses are returned if the certificate ID is invalid or the certificate has expired (i.e. is older than 90 days).

{
  "outcome": "success", 
  "reason": "This is a valid Facebook certificate id"
}

{
  "outcome": "success", 
  "reason": "This is a valid Mobile certificate id"
}

{
  "outcome": "success", 
  "reason": "This is a valid Web certificate id"
}

{
  "outcome": "failure", 
  "reason": "This is a invalid certificate id"
}

{
  "outcome": "failure", 
  "reason": "Certificate is more than 90 days old"
}