---
title: "Retrieve a batch of pre-generated certificates (the outcome of a batch certificate creation task) either as a downloadable zip file (default) or as a list of pre-signed urls."
method: GET
path: "/certificates/{taskId}"
tags: ["Bulk Certificate Creation"]
---

# Retrieve a batch of pre-generated certificates (the outcome of a batch certificate creation task) either as a downloadable zip file (default) or as a list of pre-signed urls.

`GET /certificates/{taskId}`

## Query parameters

- `downloadType` 'signedUrl' | 'zip'

## Response `200`

OK. Either a zip file as the response (default), or a list of s3 presigned urls (when ?downloadType=signedUrl).

## Other responses

- `303` — If certificate creation is still in progress, a redirect to the certificate task status endpoint.
- `404` — Not found

## Changes

- **2021-12-29** `d7859da15bfc` — 1 warning, 5 info
  - the optional response header `location` removed for the status `303`
  - api operation id `getBulkCertificates` removed and replaced with `getCertificates`
  - added the new optional `query` request parameter `downloadType`
  - added the media type `application/vnd.aws-cdf-v1.0+json` for the response with the status `200`
  - …2 more

[Change history](https://skmtc.dev/aws-samples/apis/aws-connected-device-framework-bulk-certs/changes/certificates/:taskId/get.md)

---

[API](https://skmtc.dev/aws-samples/apis/aws-connected-device-framework-bulk-certs.md) · [All operations](https://skmtc.dev/aws-samples/apis/aws-connected-device-framework-bulk-certs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/aws-connected-device-framework-bulk-certs/revisions/475b036d8661/schema)