---
title: "Federal Grant Shortlist Preflight"
method: POST
path: "/v1/grants/preflight"
tags: ["grant preflight", "shortlist", "deadline", "provenance", "Grants.gov"]
---

# Federal Grant Shortlist Preflight

`POST /v1/grants/preflight`

## Request

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

Run deterministic rule-based checks over up to five retrieved Grants.gov notices: deadline horizon, listed applicant-type code intersection, source-field completeness, and official-notice verification flags. 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
  - `opportunityIds` integer[], required
  - `applicantTypeCodes` string[]
  - `deadlineHorizonDays` integer

## Response `200`

Paid result

- object
  - `generatedAt` string, date-time, required
  - `request` object, required
    - `opportunityIds` integer[], required
    - `applicantTypeCodes` string[]
    - `deadlineHorizonDays` integer
  - `evaluatedCount` integer, required
  - `results` object[], required
    - `opportunityId` string, required
    - `screening` object, required
      - `deadlineState` 'past_due' | 'within_horizon' | 'outside_horizon' | 'ongoing' | 'unknown', required
      - `applicantTypeSignal` 'listed_code_intersects' | 'no_listed_code_intersection' | 'not_checked', required
      - `eligibilityTextState` 'present' | 'missing', required
      - `awardRangeState` 'complete' | 'partial' | 'missing', required
      - `costSharingState` 'required' | 'not_required' | 'unknown', required
      - `officialNoticeVerificationRequired` true, required: The buyer must verify the result against the complete official notice before acting.
      - `manualReviewRequired` true, required: Legacy compatibility field. True means official-notice verification is required; it does not promise human review.
      - `flags` string[], required
    - `official` object, required
    - `source` object, required
      - `publisher` 'Grants.gov', required
      - `api` string, uri, required
      - `accessedAt` string, date-time, required
      - `terms` string, uri
  - `caveat` 'Deterministic rule-based checks over the retrieved Grants.gov notice only. Applicant-type results report listed-code intersection, not eligibility. This is not an eligibility determination, legal opinion, award prediction, or government endorsement.', required
  - `attribution` 'This product uses the Grants.gov API but is not endorsed or certified by the U.S. Department of Health and Human Services.', required

## Other responses

- `402`: x402 payment required: 5.00 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)