Federal Grant Evidence

Use this when the user needs to know which official documents a U.S. federal grant opportunity has, which revision is current, and whether the official record is complete. It returns every Full Announcement, revised announcement, supporting document and application package Grants.gov holds, with official download URLs. It does not read the documents, assess eligibility, predict an award, draft, or submit.

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "string",
      "description": "Official Grants.gov opportunity ID, for example 332894",
      "pattern": "^[0-9]{4,12}$",
      "minLength": 4,
      "maxLength": 12
    }
  },
  "required": [
    "opportunity_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "string"
    },
    "opportunity_number": {
      "type": "string"
    },
    "revision": {
      "type": [
        "integer",
        "null"
      ]
    },
    "latest_history_revision": {
      "type": [
        "integer",
        "null"
      ]
    },
    "completeness": {
      "type": "string",
      "enum": [
        "COMPLETE",
        "PARTIAL",
        "UNKNOWN"
      ]
    },
    "reason_codes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "documents": {
      "type": "array"
    },
    "linked_documents": {
      "type": "array"
    },
    "packages": {
      "type": "array"
    },
    "collected_evidence": {
      "type": [
        "object",
        "null"
      ]
    }
  },
  "required": [
    "opportunity_id",
    "revision",
    "completeness",
    "documents"
  ]
}

Use this after the document manifest, when the user needs the requirements stated inside a U.S. federal grant's official announcement — eligibility, cost share, deadlines, page limits, required submissions and evaluation criteria — each with the document, page and exact source text it came from. It returns CONFIRMED, CONFLICT, UNKNOWN or EXTRACTION_INCOMPLETE per requirement and never fills a gap with an inference. It does not determine legal eligibility, predict an award, draft, or submit.

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "string",
      "description": "Official Grants.gov opportunity ID, for example 332894",
      "pattern": "^[0-9]{4,12}$",
      "minLength": 4,
      "maxLength": 12
    },
    "claim_types": {
      "type": "array",
      "description": "Optional filter; omit for every requirement class.",
      "items": {
        "type": "string"
      },
      "maxItems": 15
    }
  },
  "required": [
    "opportunity_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "enum": [
        "EVIDENCE_NOT_COLLECTED",
        "EVIDENCE_STORE_NOT_READY",
        "STALE_REVISION",
        "COLLECTED"
      ]
    },
    "snapshot_id": {
      "type": "string"
    },
    "revision": {
      "type": [
        "integer",
        "null"
      ]
    },
    "observed_at": {
      "type": "string"
    },
    "manifest_completeness": {
      "type": "string"
    },
    "coverage": {
      "type": "object"
    },
    "unread_documents": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "claims": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "detail": {
      "type": "string"
    }
  },
  "required": [
    "opportunity_id",
    "state"
  ]
}

Use this when the user needs to know what changed between revisions of a U.S. federal grant opportunity — deadlines, cost share, eligibility, funding — with the before and after value for each change and how much it matters. It reads the official revision history and reports what Grants.gov itself declared changed alongside the computed difference. It does not read announcement documents, assess eligibility, predict an award, draft, or submit.

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "string",
      "description": "Official Grants.gov opportunity ID, for example 332894",
      "pattern": "^[0-9]{4,12}$",
      "minLength": 4,
      "maxLength": 12
    },
    "since_revision": {
      "type": "integer",
      "minimum": 0,
      "description": "Optional; compare only revisions after this one."
    }
  },
  "required": [
    "opportunity_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "enum": [
        "SINGLE_REVISION",
        "HISTORY_UNAVAILABLE",
        "PARTIAL_HISTORY",
        "COMPARED"
      ]
    },
    "current_revision": {
      "type": [
        "integer",
        "null"
      ]
    },
    "revisions_observed": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "pairs_observed": {
      "type": "integer"
    },
    "pairs_compared": {
      "type": "integer"
    },
    "pairs_unavailable": {
      "type": "integer"
    },
    "worst_materiality": {
      "type": "string"
    },
    "unavailable_pairs": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "detail": {
      "type": "string"
    }
  },
  "required": [
    "opportunity_id",
    "state",
    "current_revision",
    "revisions_observed"
  ]
}

Use this when the user needs to find current or forecasted U.S. federal grant opportunities by topic. It returns official identifiers and source URLs for follow-up analysis. Do not use it to decide eligibility, predict an award, write an application, or submit anything.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Topic or phrase such as community oral health",
      "minLength": 2,
      "maxLength": 120
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results, from 1 to 20",
      "minimum": 1,
      "maximum": 20,
      "default": 8
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "count": {
      "type": "integer"
    },
    "opportunities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "number": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "agency": {
            "type": "string"
          },
          "closeDate": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "sourceUrl": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "number",
          "title",
          "agency",
          "closeDate",
          "status",
          "sourceUrl"
        ]
      }
    },
    "sourceFreshness": {
      "type": "object"
    }
  },
  "required": [
    "query",
    "count",
    "opportunities",
    "sourceFreshness"
  ]
}

Use this when the user needs a sourced go/no-go pursuit screen for one U.S. federal grant using a non-personal organization profile and the official opportunity record. The current preview is always free and explicitly marks unresolved project relevance, document, or award-history evidence. Do not use it for discovery only, legal eligibility advice, award prediction, drafting, or submission.

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Numeric Grants.gov opportunity id from search_federal_grants"
    },
    "organization": {
      "type": "object",
      "properties": {
        "entity_type": {
          "type": "string",
          "enum": [
            "state_government",
            "county_government",
            "city_or_township_government",
            "special_district_government",
            "independent_school_district",
            "public_higher_education",
            "federally_recognized_tribal_government",
            "public_housing_authority",
            "tribal_organization",
            "nonprofit_501c3",
            "nonprofit_without_501c3",
            "private_higher_education",
            "for_profit_organization",
            "small_business",
            "other"
          ]
        },
        "state": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$"
        },
        "country": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "default": "US"
        },
        "requested_amount_usd": {
          "type": "number",
          "minimum": 0
        },
        "can_meet_cost_share": {
          "type": "boolean"
        }
      },
      "required": [
        "entity_type",
        "state"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "opportunity_id",
    "organization"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string"
    },
    "chargeable": {
      "type": "boolean"
    },
    "resultCompleteness": {
      "type": "string",
      "enum": [
        "OFFICIAL_RECORD_PREVIEW",
        "OFFICIAL_PLUS_AWARD_HISTORY_PREVIEW"
      ]
    },
    "recommendation": {
      "type": "string",
      "enum": [
        "CONDITIONAL",
        "NO_GO"
      ]
    },
    "reasonCodes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "opportunity": {
      "type": "object"
    },
    "organization": {
      "type": "object"
    },
    "hardGates": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "productRelevance": {
      "type": "object"
    },
    "funding": {
      "type": "object"
    },
    "programs": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "unresolved": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "officialRecordFreshness": {
      "type": "object"
    }
  },
  "required": [
    "schemaVersion",
    "chargeable",
    "resultCompleteness",
    "recommendation",
    "reasonCodes",
    "opportunity",
    "organization",
    "hardGates",
    "productRelevance",
    "funding",
    "programs",
    "unresolved",
    "sources",
    "limitations",
    "officialRecordFreshness"
  ]
}

Use this limited free-beta tool after search or preview when the user wants a complete, versioned hard-gate and award-history evidence pack for one U.S. federal grant. It never requests payment during the beta. The service has a global daily beta capacity and counts only newly released complete results; reuse request_id for retries. It does not evaluate semantic project relevance, determine legal eligibility, predict an award, draft, or submit.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{16,160}$",
      "description": "Caller-generated stable idempotency key; reuse it for retries"
    },
    "opportunity_id": {
      "type": "string",
      "pattern": "^\\d{1,12}$",
      "description": "Numeric Grants.gov opportunity id"
    },
    "organization": {
      "type": "object",
      "properties": {
        "entity_type": {
          "type": "string",
          "enum": [
            "state_government",
            "county_government",
            "city_or_township_government",
            "special_district_government",
            "independent_school_district",
            "public_higher_education",
            "federally_recognized_tribal_government",
            "public_housing_authority",
            "tribal_organization",
            "nonprofit_501c3",
            "nonprofit_without_501c3",
            "private_higher_education",
            "for_profit_organization",
            "small_business",
            "other"
          ]
        },
        "state": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$"
        },
        "country": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "default": "US"
        },
        "requested_amount_usd": {
          "type": "number",
          "minimum": 1
        },
        "can_meet_cost_share": {
          "type": "boolean"
        }
      },
      "required": [
        "entity_type",
        "state",
        "requested_amount_usd",
        "can_meet_cost_share"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "request_id",
    "opportunity_id",
    "organization"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string",
      "const": "1.0"
    },
    "chargeable": {
      "type": "boolean"
    },
    "resultCompleteness": {
      "type": "string",
      "const": "COMPLETE_WITHIN_DECLARED_SCOPE"
    },
    "scope": {
      "type": "object"
    },
    "opportunity": {
      "type": "object"
    },
    "organization": {
      "type": "object"
    },
    "recommendation": {
      "type": "string"
    },
    "reasonCodes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "hardGates": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "funding": {
      "type": "object"
    },
    "programs": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "provenance": {
      "type": "object"
    },
    "billing": {
      "type": "object"
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "schemaVersion",
    "chargeable",
    "resultCompleteness",
    "scope",
    "opportunity",
    "organization",
    "recommendation",
    "reasonCodes",
    "hardGates",
    "funding",
    "programs",
    "provenance",
    "billing",
    "limitations"
  ]
}

Use this opt-in free-beta tool only when the user wants to test opportunity 359701 against current actual non-personal organization, project, and readiness facts. The user must explicitly attest that the facts are current, explicitly confirm intent to apply to this opportunity, and consent to storing the resulting pointer-only pack for 30 days. The raw profile, names, contact details, identifiers, narratives, documents, and credentials are not stored. Missing facts remain NEEDS_INPUT. It does not determine legal eligibility, predict an award, draft, or submit an application.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "Caller-generated UUID used only for idempotent replay"
    },
    "opportunity_id": {
      "type": "string",
      "const": "359701"
    },
    "profile": {
      "type": "object",
      "properties": {
        "schema_version": {
          "type": "string",
          "const": "2.0"
        },
        "organization": {
          "type": "object",
          "properties": {
            "entity_type": {
              "type": "string"
            },
            "legal_domicile": {
              "$ref": "#/$defs/location"
            },
            "capabilities": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "FISHING_OR_MARITIME_INVOLVEMENT",
                  "FISHING_OR_MARITIME_EXPERTISE",
                  "PUBLIC_HEALTH_AUTHORITY",
                  "CONSTITUTIONAL_PUBLIC_HEALTH_AUTHORITY",
                  "ACADEMIC_OCCUPATIONAL_SAFETY_HEALTH_CENTER",
                  "MULTI_PROJECT_PROGRAM_CAPACITY",
                  "RESEARCH_FACILITY_CONSTRUCTION_CAPACITY"
                ]
              },
              "uniqueItems": true,
              "maxItems": 16
            },
            "public_health_jurisdiction": {
              "type": "object",
              "properties": {
                "authority_confirmed": {
                  "type": "boolean"
                },
                "constitutional_authority_confirmed": {
                  "type": "boolean"
                },
                "population": {
                  "type": "integer",
                  "minimum": 0
                },
                "attachment_a_listed": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          },
          "required": [
            "entity_type",
            "legal_domicile"
          ],
          "additionalProperties": false
        },
        "project": {
          "type": "object",
          "properties": {
            "requested_amount_usd": {
              "type": "number",
              "minimum": 0
            },
            "total_cost_usd": {
              "type": "number",
              "minimum": 0
            },
            "requested_federal_amount_per_budget_period_usd": {
              "type": "number",
              "minimum": 0
            },
            "requested_federal_amount_project_total_usd": {
              "type": "number",
              "minimum": 0
            },
            "duration_months": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1200
            },
            "committed_cost_share_percent": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "project_kinds": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "RESEARCH",
                  "PUBLIC_HEALTH_RESPONSE",
                  "FAMILY_PLANNING_SERVICES",
                  "RESEARCH_FACILITY_CONSTRUCTION",
                  "RESEARCH_FACILITY_MODERNIZATION",
                  "EDUCATION_AND_RESEARCH_CENTER"
                ]
              },
              "uniqueItems": true,
              "maxItems": 12
            },
            "performance_sites": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/location"
              },
              "maxItems": 300
            },
            "affected_areas": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/location"
              },
              "maxItems": 300
            },
            "service_areas": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/location"
              },
              "maxItems": 300
            },
            "has_foreign_components": {
              "type": "boolean"
            },
            "has_foreign_collaborators": {
              "type": "boolean"
            },
            "collects_public_health_data": {
              "type": "boolean"
            },
            "involves_human_subjects": {
              "type": "boolean"
            },
            "multi_institution_human_subjects_research": {
              "type": "boolean"
            },
            "involves_clinical_trial": {
              "type": "boolean"
            },
            "involves_research": {
              "type": "boolean"
            },
            "requests_indirect_costs": {
              "type": "boolean"
            },
            "has_non_federal_financial_support": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        },
        "readiness": {
          "type": "object",
          "properties": {
            "application_count_for_institution": {
              "type": "integer",
              "minimum": 0
            },
            "application_count_for_same_project": {
              "type": "integer",
              "minimum": 0
            },
            "registrations": {
              "type": "object",
              "properties": {
                "SAM": {
                  "type": "boolean"
                },
                "UEI": {
                  "type": "boolean"
                },
                "GRANTS_GOV": {
                  "type": "boolean"
                },
                "ERA_COMMONS": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            },
            "current_award_mechanisms": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 32
              },
              "uniqueItems": true,
              "maxItems": 40
            },
            "current_application_mechanisms": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 32
              },
              "uniqueItems": true,
              "maxItems": 40
            },
            "prepared_submission_ids": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 100
              },
              "uniqueItems": true,
              "maxItems": 200
            },
            "component_form_readiness": {
              "type": "array",
              "maxItems": 30,
              "items": {
                "type": "object",
                "properties": {
                  "component_type": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  },
                  "instance_count": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 20
                  },
                  "prepared_form_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "uniqueItems": true,
                    "maxItems": 30
                  }
                },
                "required": [
                  "component_type",
                  "instance_count",
                  "prepared_form_ids"
                ],
                "additionalProperties": false
              }
            }
          },
          "additionalProperties": false
        }
      },
      "required": [
        "schema_version",
        "organization",
        "project",
        "readiness"
      ],
      "additionalProperties": false,
      "$defs": {
        "location": {
          "type": "object",
          "properties": {
            "country_code": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            },
            "subdivision_code": {
              "type": "string",
              "pattern": "^[A-Za-z0-9-]{1,12}$"
            },
            "county_name": {
              "type": "string",
              "maxLength": 120
            },
            "municipality_name": {
              "type": "string",
              "maxLength": 120
            }
          },
          "required": [
            "country_code"
          ],
          "additionalProperties": false
        }
      }
    },
    "attest_current_actual_non_personal_facts": {
      "type": "boolean",
      "const": true
    },
    "attest_intends_to_apply_to_opportunity_359701": {
      "type": "boolean",
      "const": true
    },
    "consent_to_store_pointer_only_result": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "request_id",
    "opportunity_id",
    "profile",
    "attest_current_actual_non_personal_facts",
    "attest_intends_to_apply_to_opportunity_359701",
    "consent_to_store_pointer_only_result"
  ],
  "additionalProperties": false,
  "$defs": {
    "location": {
      "type": "object",
      "properties": {
        "country_code": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$"
        },
        "subdivision_code": {
          "type": "string",
          "pattern": "^[A-Za-z0-9-]{1,12}$"
        },
        "county_name": {
          "type": "string",
          "maxLength": 120
        },
        "municipality_name": {
          "type": "string",
          "maxLength": 120
        }
      },
      "required": [
        "country_code"
      ],
      "additionalProperties": false
    }
  }
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string",
      "const": "1.0-beta-profile-proof"
    },
    "stored": {
      "type": "boolean"
    },
    "storageDisposition": {
      "type": "string"
    },
    "profileInputStored": {
      "type": "boolean",
      "const": false
    },
    "proof": {
      "type": "object"
    },
    "pack": {
      "type": "object"
    }
  },
  "required": [
    "schemaVersion",
    "stored",
    "storageDisposition",
    "profileInputStored",
    "pack"
  ]
}