TagMangoTagMango Docs
Certificate

Get Certificates

GET
/api/v1/external/certificates

Get all the certificates created by a creator.

AuthorizationBearer <token>

In: header

Query Parameters

limit?number

Number of items per page of the results

Range1 <= value
page?number

Page number of the results

Range1 <= value
mangoes?string

Comma-separated list of mango unique identifiers, if provided, certificates will be filtered based on the mangoes

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Response Body

application/json

application/json

application/json

curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/certificates" \  -H "x-whitelabel-host: string"
[
  {
    "_id": "659bda0d1f30911c18766b31",
    "creator": "6149b1e5612c4e5fd96041d3",
    "aliasCreator": "62ea773dfc87495de3894e73",
    "title": "Certificate of Completion - Advanced React Course",
    "content": "This certificate is awarded for successfully completing the Advanced React Course with excellence.",
    "signature": "https://cdn.example.com/signatures/john-doe-signature.png",
    "logo": "https://cdn.example.com/logos/company-logo.png",
    "for": "course",
    "template": "template_1",
    "course": "66a1390268a76f2f5c9f39a3",
    "workshop": "77b2390268a76f2f5c9f39a4",
    "mango": "88c3390268a76f2f5c9f39a5",
    "sentAt": "2024-01-15T10:30:00.000Z",
    "lastScheduledCount": 5,
    "lastSentCount": 3,
    "autoSend": false,
    "issueDate": "2024-01-10T00:00:00.000Z",
    "additionalSignatures": [
      "https://cdn.example.com/signatures/co-instructor.png",
      "https://cdn.example.com/signatures/department-head.png"
    ],
    "cover": "https://cdn.example.com/covers/certificate-cover.jpg",
    "isDeleted": false,
    "uniqueIdEnabled": true,
    "awardName": "Excellence in React Development",
    "createdAt": "2024-01-08T11:18:37.217Z",
    "updatedAt": "2024-01-10T14:25:42.331Z"
  }
]
{
  "code": 400,
  "type": "Bad request",
  "statusMessage": "BAD_REQUEST",
  "message": "Invalid request",
  "success": false
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "success": false
}