---
title: "U.S. Federal Grant Opportunity Search"
method: GET
path: "/v1/grants/search"
tags: ["grants", "funding", "deadline", "eligibility", "Grants.gov"]
---

# U.S. Federal Grant Opportunity Search

`GET /v1/grants/search`

## Request

- Base URL: `https://genuinegood.online`
- URL: `https://genuinegood.online/v1/grants/search`
- Auth: none declared

Search current Grants.gov opportunities with normalized deadlines, days remaining, agency, status, assistance listing numbers, and official source links. GET compatibility accepts the same input as query parameters. Array values may be comma-separated.

## Query parameters

- `keyword` string, required: Plain-language mission or funding topic
- `statuses` string[]
- `rows` integer
- `offset` integer: Zero-based starting record offset for paginating search results
- `agencies` string[]: Optional Grants.gov agency codes
- `eligibilityCodes` string[]
- `fundingCategories` string[]: Optional Grants.gov funding activity category codes
- `fundingInstruments` string[]: Optional Grants.gov funding instrument codes

## Headers

- `PAYMENT-SIGNATURE` string

## Response `200`

Paid result

- object
  - `query` object, required
  - `totalMatches` integer, required
  - `pagination` object, required
    - `offset` integer, required
    - `rows` integer, required
    - `totalMatches` integer, required
    - `hasMore` boolean, required
    - `nextOffset` integer, nullable, required
  - `opportunities` object[], required
    - `id` string, required
    - `title` string, required
    - `agency` string
    - `status` string
    - `deadline` string, nullable
    - `closeDate` string, nullable
    - `daysRemaining` integer, nullable
    - `officialUrl` string, uri, required
  - `source` object, required
    - `publisher` 'Grants.gov', required
    - `api` string, uri, required
    - `accessedAt` string, date-time, required
    - `terms` string, uri
  - `caveat` string, required

## Other responses

- `402`: x402 payment required: 0.05 USDC on Base mainnet

---

[API](https://skmtc.dev/genuinegood/apis/genuine-good-grants-genuine-good-grants-api.md) · [All operations](https://skmtc.dev/genuinegood/apis/genuine-good-grants-genuine-good-grants-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genuinegood/apis/genuine-good-grants-genuine-good-grants-api/revisions/5511533a9771?raw)