TagMangoTagMango Docs
Certificate

List User Certificates

GET
/api/v1/external/certificates/{userId}

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 _id descending.
  • 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.

AuthorizationBearer <token>

In: header

Path Parameters

userId*string

User ID from Lookup User by Email or Phone. The user must belong to the authenticated host.

Query Parameters

types?string

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.

mangoes?string

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

x-whitelabel-host*string

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
}