---
title: "U.S. federal contract search"
method: POST
path: "/v1/research/us-contract-search"
tags: ["research"]
---

# U.S. federal contract search

`POST /v1/research/us-contract-search`

## Request

- Base URL: `https://apiacre.com`
- URL: `https://apiacre.com/v1/research/us-contract-search`
- Auth: none required

Search public USAspending prime federal procurement awards by recipient company or organization name, UEI, or legacy DUNS, returning bounded contract values, agencies, performance dates, descriptions, official award links, and explicit interpretation limits.

Price: **$0.02 USDC** via x402 exact payment on Base and Solana.

## Request body

- UsContractSearchInput
  - `recipient_query` string, required: Recipient organization name, UEI, or legacy DUNS to search across public USAspending prime-contract records
  - `start_date` string, date, nullable: Optional inclusive award-action lower bound; defaults to five years before end_date
  - `end_date` string, date, nullable: Optional inclusive award-action upper bound; defaults to today
  - `minimum_award_amount` integer, nullable: Optional minimum current aggregate contract-award amount in whole USD
  - `maximum_award_amount` integer, nullable: Optional maximum current aggregate contract-award amount in whole USD
  - `max_results` integer: Maximum highest-award-amount prime contracts returned

## Response `200`

Successful Response

- ServiceResponse
  - `request_id` string, required
  - `service` string, required
  - `version` string
  - `data` object, required
  - `meta` ServiceMeta, required
    - `duration_ms` integer, required
    - `cached` boolean
    - `sources` string[]
    - `warnings` string[]
    - `next_actions` ServiceNextAction[]
      - `service` string, required
      - `title` string, required
      - `reason` string, required
      - `method` 'POST'
      - `path` string, required
      - `price` string, required
      - `input_template` object, required
      - `use_output` string, required
      - `handoff_path` string, required
      - `checkout_path` string, required
      - `sample_path` string, nullable, required
      - `maximum_atomic_usdc` string, required
      - `handoff_payment_required` false
      - `executes_automatically` false
      - `authorization_required` boolean

## Other responses

- `402`: Payment Required. Decode PAYMENT-REQUIRED, satisfy the x402 requirement, and retry with PAYMENT-SIGNATURE.
- `422`: Validation Error

---

[API](https://skmtc.dev/apiacre/apis/api-acre.md) · [All operations](https://skmtc.dev/apiacre/apis/api-acre/llms.txt) · [OpenAPI document](https://skmtc.dev/apiacre/apis/api-acre/revisions/0ba942b920ad?raw)