Getting a Link to Download a Certificate
AVAILABLE WITH BUSINESS SUBSCRIPTION
Request: GET /certificate/{issuedCertificateId}
Using this method, you can get a link to download a certificate for a specific enrollment. You don’t need to download certificates for all enrollments.
Permissions to Run the Request
Account Owner, Account Administrators, Department Administrators or custom roles that allow to view users.
Department Administrators, and users with a custom role can get list of enrollments assigned to learners belonging to the departments they manage and their sub-departments.
Request Headers
Header | Description |
|---|---|
| Authorization (required) | Access token. You can obtain a token by making a request. |
| Accept: application/json (required) | Format of the response data: JSON |
| Parameter | Description |
| issuedCertificateId (required) | The certificate ID (token) from the list of enrollments. |
Existing customers may continue using ispringlearn.com, and new customers should use ispring.com.
Response Parameters
| Parameter | Description |
|---|---|
| url | Link to download the certificate as a PDF. |
Response Codes
| Code | Text | Description |
|---|---|---|
| 200 | OK | The request has been successfully processed. |
| 400 | Bad Request | A request error. |
| 401 | Unauthorized | An authorization error. |
| 403 | Permission Denied | The user doesn't have enough permissions to get certificate information. |
| 404 | Not Found | The certificate was not found. |
Note:
- You can only get the certificate for active assignments. The certificates for archived and deleted enrollments can not be downloaded using this method.
- You can receive certificate issued for courses, learning tracks and standalone content items.
The link to download the certificate is available during the token’s validity period of 10 minutes.
- If there is a token, then the updated certificate is downloaded.
- If the token expires, then the download link does not work. You need to generate a new download token.
Sample Request
GET /certificate/66b4ed00-040e-11ed-a8a2-b6f58d6fa7b5 HTTP/1.1
Host: api-learn.ispringlearn.com
Accept: application/json
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
CODE
Sample Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"url": "https://myaccount.ispringlearn.com/download/v1/certificate/66b4ed00-040e-11ed-a8a2-b6f58d6fa7b5?token=..."
}
CODE