# Grants (/docs/indicators/grants)



Grant indicators are available through:

* `POST /indicators/grants/proofpoints`
* `POST /indicators/grants/time-series`

## What Is Different About Grants [#what-is-different-about-grants]

Grants use project intervals (`start_date`, `end_date`) rather than publication dates.

* Use `interval_overlap` in `query` to filter projects by date overlap.
* For time series, provide `start` and `end` to define the chart window.
* `time-series` returns both project counts and `amount` (capital exposure) per bucket.

## Typical Questions [#typical-questions]

* Which grants are active in this topic and period?
* Is active project volume increasing or declining across the chosen window?
* How much total project capital is exposed month-by-month?

## Request Patterns [#request-patterns]

### Proofpoints [#proofpoints]

Use the same nested query style as other document indicators, but with `interval_overlap` for project dates.

```json
{
  "query": {
    "type": "and",
    "clauses": [
      {
        "type": "query",
        "query": "battery recycling"
      },
      {
        "type": "interval_overlap",
        "start": "2022-01-01",
        "end": "2024-12-31"
      }
    ]
  },
  "take": 25,
  "skip": 0,
  "sortColumn": "published_at",
  "sortDirection": "desc"
}
```

### Time Series [#time-series]

`start` and `end` define bucket generation for the output series.

```json
{
  "resolution": "month",
  "start": "2022-01-01",
  "end": "2024-12-31",
  "query": {
    "type": "interval_overlap",
    "start": "2022-01-01",
    "end": "2024-12-31"
  }
}
```

## Response Notes [#response-notes]

* `labels`: bucket labels at the selected resolution.
* `counts`: number of active overlapping projects in each bucket.
* `amount`: rounded, time-weighted capital exposure per bucket.
  * Uses project `total_cost`.
  * Falls back to `cordis_ec_contribution` when `total_cost` is missing or `0`.

## Validation Notes [#validation-notes]

* `DateFilter` is not supported for grants. Use `interval_overlap` instead.
* `start` must be on or before `end`.
* Score-weighted time series options are not supported on grant time series.