---
title: "Download Contract Award Extract from S3"
method: GET
path: "/contract-awards/v1/download"
tags: ["contract-award-controller"]
---

# Download Contract Award Extract from S3

`GET /contract-awards/v1/download`

## Request

- Base URL: `https://api.sam.gov`
- URL: `https://api.sam.gov/contract-awards/v1/download`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gsa/apis/contract-award-api/docs/contract-awards/v1/download/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `exportLoggingInfo` ExportLoggingInfo, required
  - `api_key` string
  - `fileName` string
  - `id` integer
  - `userId` string
  - `domain` string
  - `downloadType` integer
  - `format` string
  - `searchType` string
  - `searchCriteria` string
  - `createDate` string, date-time
  - `expireDate` string, date-time
  - `status` string
  - `fileLocationS3` string
  - `lastDownloadDate` string, date-time
  - `lastUpdatedDate` string, date-time
  - `token` string
  - `count` integer
  - `searchURL` string
  - `sensitivityLevel` string
  - `message` string
  - `expired` boolean
  - `deleted` boolean
- `api_key` string, required
- `token` string, required
- `ttl` string, required

## Response `200`

ZIP file containing award data

## Other responses

- `403`: Expired API Key Invalid API Key
- `404`: File Not Found
- `500`: Internal Server Error

## Changes

- **2025-12-10** (v1) `87ab11d503a1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gsa/apis/contract-award-api/changes/contract-awards/v1/download/get.md)

---

[API](https://skmtc.dev/gsa/apis/contract-award-api.md) - [All operations](https://skmtc.dev/gsa/apis/contract-award-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gsa/apis/contract-award-api/revisions/87ab11d503a1?raw)