List User Certificates
Lists completed certificates recorded for a user. Use List Certificates to view the certificate definitions referenced in the response.
Result behavior
- Each user certificate is returned separately. The same certificate definition can appear more than once.
- All supplied filters are combined.
- Only completed certificates are returned, ordered newest first. Ties are ordered by
_iddescending. - Results are not paginated.
External access policy
An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.
These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.
-
Plans: Unrestricted.
-
Tiers: Unrestricted.
Authorization
bearer In: header
Path Parameters
User ID from Lookup User by Email or Phone. The user must belong to the authenticated host.
Query Parameters
Comma-separated sources to include: mango, course, workshop, custom. Omit to include all sources. Values are case-sensitive. Whitespace is trimmed and duplicates are ignored. Empty or unknown values are rejected.
Comma-separated Mango IDs from List Mangoes. This filter applies only to mango records; other selected sources are not affected. Omit it to include all Mangoes.
Header Parameters
Host name of the dashboard, ex: mydomain.tagmango.com
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/certificates/646dd0eb159d8b7a7f5a9c29" \ -H "x-whitelabel-host: string"[
{
"_id": "66558085afa45d0583eb71bd",
"type": "course",
"certificate": "6658283d53930c22585d9ba1",
"mango": "66558042b487b3571f73305d",
"course": "6673e682795c63a142d2a3f0",
"workshop": "6673e6a9795c63a142d2a441",
"certificateUrl": "https://cdn.example.com/certificates/66558085afa45d0583eb71bd.pdf",
"certificateReceivedOn": "2024-06-03T09:59:34.308Z"
}
]{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"success": false,
"message": "Invalid request",
"result": "Invalid request"
}{
"code": 401,
"type": "Unauthorized",
"statusMessage": "UNAUTHORIZED",
"message": "Invalid token",
"result": "Invalid token",
"success": false
}{
"code": 403,
"type": "Forbidden",
"statusMessage": "FORBIDDEN",
"errorCode": "WORKSHOP_MANGO_FORBIDDEN",
"message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"success": false
}{
"code": 404,
"type": "Not Found",
"statusMessage": "NOT_FOUND",
"errorCode": "USER_NOT_FOUND",
"message": "The user does not exist or belongs to another host. Use [Lookup User by Email or Phone](https://docs.tagmango.com/docs/api-reference/account/lookupUserByEmailOrPhone) to find the correct user ID.",
"result": "The user does not exist or belongs to another host. Use [Lookup User by Email or Phone](https://docs.tagmango.com/docs/api-reference/account/lookupUserByEmailOrPhone) to find the correct user ID.",
"success": false
}{
"code": 429,
"type": "Too Many Requests",
"statusMessage": "TOO_MANY_REQUESTS",
"message": "Request limit exceeded. try after 10 seconds",
"result": "Request limit exceeded. try after 10 seconds",
"success": false
}