Skip to main content
GET
List awards

Request

At least one filter is required: start_date, unique_keys[], or recipient_ueis[].

Date Range Filtering

string
Start date for filtering awards by last modified date (ISO 8601 format, e.g., “2024-01-15”). Required unless filtering by unique_keys[] or recipient_ueis[].
string
End date for filtering awards by last modified date (ISO 8601 format). Defaults to 7 days after start_date if not provided. Maximum date range is 7 days.

Identifier Filtering

string[]
Array of award unique keys (e.g., FPDS PIID) to retrieve. Maximum 100 values. When provided, start_date is not required.
string[]
Array of recipient UEIs to filter by. Maximum 100 values. When provided, start_date is not required.

Pagination

integer
default:100
Number of results per page. Maximum: 100.
string
Base64-encoded cursor for pagination. Use the nextCursor value from the previous response to get the next page of results.

Response

Returns an array of award objects with pagination metadata.
array
Array of award objects
object
Pagination metadata

Error Responses

Common validation errors:
  • “At least one filter is required: start_date, unique_keys, or recipient_ueis”
  • “Date range cannot exceed 7 days”
  • “unique_keys cannot exceed 100 values”
  • “recipient_ueis cannot exceed 100 values”
  • “Invalid start_date format”
  • “Invalid end_date format”

Example Requests

Filter by date range

Filter by unique keys

Filter by recipient UEIs

Paginate through results