---
title: "Search Grants"
method: POST
path: "/api/v3/grants/search"
tags: ["Grants"]
---

# Search Grants

`POST /api/v3/grants/search`

## Request body

- AppTypesGrantGrantSearchFilters
  - `include_words` string[], nullable
  - `exclude_words` string[], nullable
  - `keyword_logic` string, nullable
  - `title_only` boolean
  - `min_amount` number, nullable
  - `max_amount` number, nullable
  - `funding_agencies_include` string[], nullable
  - `funding_agencies_exclude` string[], nullable
  - `funding_period_start` string, date, nullable
  - `funding_period_end` string, date, nullable
  - `funding_statuses` FundingStatusEnum[], nullable
  - `selected_states` string[], nullable
  - `selected_institution_types` string[], nullable
  - `institutions_include` string[], nullable
  - `offset` integer
  - `limit` integer

## Response `200`

Successful Response

- PaginatedResponseGrantDetailResponse
  - `results` GrantDetailResponse[], required
    - `id` string, required
    - `title` string, required
    - `description` string, nullable
    - `funding_agency` string, required
    - `awardee_name` string, nullable
    - `total_obligated_amount` number, required
    - `period_of_performance_start_date` string, date, nullable
    - `period_of_performance_end_date` string, date, nullable
    - `last_modified_date` string, date, required
    - `grant_link` string, nullable
    - `outlayed_amount` number, nullable
    - `external_grant_id` string, nullable
    - `transaction_count` integer
    - `institution_name` string, nullable
    - `institution_state` string, nullable
    - `institution_type` string, nullable
    - `institution_id` string, nullable
    - `relevance_rank` number, nullable
    - `score` number, nullable
    - `relevance_score` number, nullable
    - `decay_score` number, nullable
    - `transactions` GrantTransactionResponse[]
      - `id` string, required
      - `institution_id` string, nullable, required
      - `total_obligated_amount` number, required
      - `outlayed_amount` number, nullable, required
      - `period_of_performance_start_date` string, date, nullable, required
      - `period_of_performance_end_date` string, date, nullable, required
      - `last_modified_date` string, date, nullable, required
      - `source_url` string, nullable, required
      - `action_type` string, nullable, required
      - `action_type_description` string, nullable, required
      - `awardee_name` string, nullable
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)