---
title: "Federal Grant Opportunity Brief"
method: POST
path: "/v1/grants/brief"
tags: ["grant brief", "funding opportunities", "eligibility", "deadline calendar", "research"]
---

# Federal Grant Opportunity Brief

`POST /v1/grants/brief`

## Request

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

Produce a sourced agent-ready brief of up to ten current U.S. federal grant matches, eligibility signals, deadline urgency, award ranges, and next actions. Payment flow: send the request without PAYMENT-SIGNATURE, read PAYMENT-REQUIRED from the 402 response, sign one accepted option, then retry the identical request with PAYMENT-SIGNATURE.

## Headers

- `PAYMENT-SIGNATURE` string

## Request body

- object
  - `mission` string, required
  - `keywords` string[], required
  - `eligibilityCodes` string[]
  - `deadlineDays` integer

## Response `200`

Paid result

- object
  - `generatedAt` string, date-time, required
  - `headline` string, required
  - `urgentDeadlinesWithin30Days` integer, 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
  - `nextActions` string[], 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.50 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)