---
title: "Search FPDS prime contract transactions by UEI, PIID, agency, NAICS"
method: GET
path: "/api/v1/contracts/search"
tags: ["Contracts"]
---

# Search FPDS prime contract transactions by UEI, PIID, agency, NAICS

`GET /api/v1/contracts/search`

## Request

- Base URL: `https://govconapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://govconapi.com/api/v1/contracts/search`
- Auth: HTTP bearer

Per conventions §1.1, §3.5, §4.2, §5, §6.1, §9.3 and ARCHITECTURE.md §4.1.

## Query parameters

- `uei` string, nullable: Recipient UEI (exact)
- `parent_uei` string, nullable: Recipient parent UEI (corporate roll-up)
- `piid` string, nullable: Award PIID (exact)
- `parent_piid` string, nullable: Parent award PIID (vehicle/IDV)
- `agency` string, nullable: Awarding agency name substring (case-insensitive)
- `naics` string, nullable: NAICS, exactly 6 digits
- `award_type_code` string, nullable: FPDS award type: A, B, C, or D
- `date_from` string, nullable: YYYY-MM-DD (action_date)
- `date_to` string, nullable: YYYY-MM-DD (action_date)
- `amount_min` number, nullable: federal_action_obligation min
- `amount_max` number, nullable: federal_action_obligation max
- `sort_by` string, nullable
- `sort_order` string, nullable
- `limit` integer
- `offset` integer
- `fields` string, nullable: lean | expanded | full | comma-list of columns

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/govconapi/apis/govcon-api.md) · [All operations](https://skmtc.dev/govconapi/apis/govcon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govconapi/apis/govcon-api/revisions/32e498016218?raw)