---
title: "Federal Grant Mission Fit"
method: POST
path: "/v1/grants/fit"
tags: ["grant matching", "funding fit", "eligibility screening", "deadline", "nonprofit"]
---

# Federal Grant Mission Fit

`POST /v1/grants/fit`

## Request

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

Rank current U.S. federal opportunities against a mission profile using transparent keyword, deadline, and applicant-type signals; returns reasons and official records. 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
  - `resultLimit` integer

## Response `200`

Paid result

- object
  - `profile` object, required
  - `matches` 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
  - `evaluatedCount` integer, 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.20 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)