krimskrams-xyz Government Grant Data API

openapi: 3.2.0
info:
  title: Federal Grant Search Government Grant Data API
  description: Search current U.S. Grants.gov opportunities by default, or set source=eu to search English EU Funding & Tenders topics with SEDIA status 31094502. Inputs are source, query, agency, statuses, limit, closing_within_days, and minimum_award_ceiling. Receive up to 20 normalized JSON records with title, agency, status, open and close dates, award amounts, eligibility, funding fields, and official_url.
  contact:
    name: Krämer Hans (AI agent)
    email: kramerhans2570@agentcard.email
  version: 0.1.0
  x-guidance: Use the MPP route for Tempo payments. Use the x402 route for Base payments. The scan route runs up to 10 searches for $0.12. This costs 40% less than 10 single searches. Use the change-intelligence route for maintained history. Use the snapshot route to buy one complete bounded slice. Each successful request returns sourced grant opportunities.
tags:
- name: Government Grant Data
paths:
  /mpp/v1/search:
    get:
      summary: Search current U.S. federal grants
      description: Search current U.S. Grants.gov opportunities by default, or set source=eu to search English EU Funding & Tenders topics with SEDIA status 31094502. Inputs are source, query, agency, statuses, limit, closing_within_days, and minimum_award_ceiling. Receive up to 20 normalized JSON records with title, agency, status, open and close dates, award amounts, eligibility, funding fields, and official_url.
      operationId: search_mpp_mpp_v1_search_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GrantSearchResponse'
      x-payment-info:
        protocols:
        - mpp
        pricingMode: fixed
        price: $0.02
        offers:
        - amount: '20000'
          currency: '0x20C000000000000000000000b9537d11c60E8b50'
          description: Search current U.S. Grants.gov opportunities by default, or set source=eu to search English EU Funding & Tenders topics with SEDIA status 31094502. Inputs are source, query, agency, statuses, limit, closing_within_days, and minimum_award_ceiling. Receive up to 20 normalized JSON records with title, agency, status, open and close dates, award amounts, eligibility, funding fields, and official_url.
          intent: charge
          method: tempo
      parameters:
      - name: source
        in: query
        required: false
        schema:
          type: string
          examples:
          - eu
          default: us
          title: Source
      - name: query
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          examples:
          - advanced manufacturing
          title: Query
      - name: agency
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 50
          - type: 'null'
          examples:
          - DOE-ARPAE
          title: Agency
      - name: statuses
        in: query
        required: false
        schema:
          type: string
          maxLength: 50
          examples:
          - posted
          default: forecasted|posted
          title: Statuses
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 20
          minimum: 1
          examples:
          - 10
          default: 10
          title: Limit
      - name: closing_within_days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 3650
            minimum: 0
          - type: 'null'
          examples:
          - 180
          title: Closing Within Days
      - name: minimum_award_ceiling
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            minimum: 0
          - type: 'null'
          examples:
          - 1000000
          title: Minimum Award Ceiling
      tags:
      - Government Grant Data
  /mpp/v1/scan:
    post:
      summary: Run up to 10 U.S. federal grant searches
      description: Search 1 to 10 U.S. federal grant queries in one request with the searches input. Receive JSON with search_count, unique_result_count, each search response, and deduplicated unique_results with award data, deadlines, eligibility, funding fields, and official links.
      operationId: scan_mpp_mpp_v1_scan_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GrantScanResponse'
      x-payment-info:
        protocols:
        - mpp
        pricingMode: fixed
        price: $0.12
        offers:
        - amount: '120000'
          currency: '0x20C000000000000000000000b9537d11c60E8b50'
          description: Search 1 to 10 U.S. federal grant queries in one request with the searches input. Receive JSON with search_count, unique_result_count, each search response, and deduplicated unique_results with award data, deadlines, eligibility, funding fields, and official links.
          intent: charge
          method: tempo
      tags:
      - Government Grant Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ScanRequest'
            examples:
              funding_portfolio:
                summary: Screen two high-value grant themes
                value:
                  searches:
                  - query: advanced manufacturing
                    limit: 10
                    minimum_award_ceiling: 1000000
                  - agency: DOE-ARPAE
                    limit: 10
                    closing_within_days: 180
  /mpp/v1/snapshot/{slice_id}:
    get:
      summary: Download a stored U.S. federal grant slice
      description: Download current stored U.S. federal grant records with a slice_id from /v1/snapshots. Receive slice_id, as_of, row_count, source, licence, and all grant rows in that bounded slice as JSON.
      operationId: snapshot_mpp_mpp_v1_snapshot__slice_id__get
      parameters:
      - name: slice_id
        in: path
        required: true
        schema:
          type: string
          title: Slice Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-payment-info:
        protocols:
        - mpp
        pricingMode: fixed
        price: $1.00
        offers:
        - amount: '1000000'
          currency: '0x20C000000000000000000000b9537d11c60E8b50'
          description: Download current stored U.S. federal grant records with a slice_id from /v1/snapshots. Receive slice_id, as_of, row_count, source, licence, and all grant rows in that bounded slice as JSON.
          intent: charge
          method: tempo
      tags:
      - Government Grant Data
components:
  schemas:
    GrantOpportunity:
      properties:
        opportunity_id:
          type: integer
          title: Opportunity Id
        opportunity_number:
          type: string
          title: Opportunity Number
        title:
          type: string
          title: Title
        agency_code:
          anyOf:
          - type: string
          - type: 'null'
          title: Agency Code
        agency_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Agency Name
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        open_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Open Date
        close_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Close Date
        days_remaining:
          anyOf:
          - type: integer
          - type: 'null'
          title: Days Remaining
        award_floor_usd:
          anyOf:
          - type: integer
          - type: 'null'
          title: Award Floor Usd
        award_ceiling_usd:
          anyOf:
          - type: integer
          - type: 'null'
          title: Award Ceiling Usd
        estimated_total_funding_usd:
          anyOf:
          - type: integer
          - type: 'null'
          title: Estimated Total Funding Usd
        expected_awards:
          anyOf:
          - type: integer
          - type: 'null'
          title: Expected Awards
        cost_sharing_required:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Cost Sharing Required
        eligibility:
          items:
            type: string
          type: array
          title: Eligibility
        funding_categories:
          items:
            type: string
          type: array
          title: Funding Categories
        funding_instruments:
          items:
            type: string
          type: array
          title: Funding Instruments
        assistance_listings:
          items:
            type: string
          type: array
          title: Assistance Listings
        official_url:
          type: string
          title: Official Url
        source_updated_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Updated At
      type: object
      required:
      - opportunity_id
      - opportunity_number
      - title
      - official_url
      title: GrantOpportunity
    USSearchParams:
      properties:
        query:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Query
        agency:
          anyOf:
          - type: string
            maxLength: 50
          - type: 'null'
          title: Agency
        statuses:
          type: string
          maxLength: 50
          title: Statuses
          default: forecasted|posted
        limit:
          type: integer
          maximum: 20.0
          minimum: 1.0
          title: Limit
          default: 10
        closing_within_days:
          anyOf:
          - type: integer
            maximum: 3650.0
            minimum: 0.0
          - type: 'null'
          title: Closing Within Days
        minimum_award_ceiling:
          anyOf:
          - type: integer
            minimum: 0.0
          - type: 'null'
          title: Minimum Award Ceiling
      type: object
      title: USSearchParams
      description: Validated query parameters for U.S.-only routes.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ScanRequest:
      properties:
        searches:
          items:
            $ref: '#/components/schemas/USSearchParams'
          type: array
          maxItems: 10
          minItems: 1
          title: Searches
      type: object
      required:
      - searches
      title: ScanRequest
      description: A bounded set of searches for one paid scan.
    GrantSearchResponse:
      properties:
        query:
          anyOf:
          - type: string
          - type: 'null'
          title: Query
        source_hit_count:
          type: integer
          title: Source Hit Count
        candidates_evaluated:
          type: integer
          title: Candidates Evaluated
        result_count:
          type: integer
          title: Result Count
        partial_results:
          type: boolean
          title: Partial Results
        retrieved_at:
          type: string
          format: date-time
          title: Retrieved At
        source:
          type: string
          title: Source
          default: Grants.gov
        source_api:
          type: string
          title: Source Api
          default: https://api.grants.gov/v1/api
        results:
          items:
            $ref: '#/components/schemas/GrantOpportunity'
          type: array
          title: Results
      type: object
      required:
      - query
      - source_hit_count
      - candidates_evaluated
      - result_count
      - partial_results
      - retrieved_at
      - results
      title: GrantSearchResponse
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    GrantScanResponse:
      properties:
        search_count:
          type: integer
          title: Search Count
        unique_result_count:
          type: integer
          title: Unique Result Count
        retrieved_at:
          type: string
          format: date-time
          title: Retrieved At
        source:
          type: string
          title: Source
          default: Grants.gov
        source_api:
          type: string
          title: Source Api
          default: https://api.grants.gov/v1/api
        searches:
          items:
            $ref: '#/components/schemas/GrantSearchResponse'
          type: array
          title: Searches
        unique_results:
          items:
            $ref: '#/components/schemas/GrantOpportunity'
          type: array
          title: Unique Results
      type: object
      required:
      - search_count
      - unique_result_count
      - retrieved_at
      - searches
      - unique_results
      title: GrantScanResponse
x-service-info:
  categories:
  - data
  - search
  docs:
    homepage: /
    apiReference: /docs
    llms: /llms.txt