---
title: "GET /funders"
method: GET
path: "/funders"
tags: ["Funders"]
---

# GET /funders

`GET /funders`

## Request

- Base URL: `https://api.crossref.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.crossref.org/funders`
- Auth: none declared
- TypeScript: <https://skmtc.dev/crossref/apis/crossref-rest-api/docs/funders/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of all funders in the [Funder Registry](https://gitlab.com/crossref/open_funder_registry).

`filter`: See [our documentation website](https://www.crossref.org/documentation/retrieve-metadata/rest-api/rest-api-filters/) for a full list of available filters. This endpoint supports the following filters:

 + `location` - funders located in given country

## Query parameters

- `filter` string
- `cursor` string
- `query` string
- `rows` integer
- `mailto` string
- `offset` integer

## Response `200`

A list of funders.

- FundersMessage
  - `status` string, required
  - `message-type` string, required
  - `message-version` string, required
  - `message` Funders, required
    - `items-per-page` integer, required
    - `query` Query, required
      - `start-index` integer, required
      - `search-terms` integer, required
    - `total-results` integer, required
    - `items` Funder[], required
      - `id` string, required: The id of the funder
      - `location` string, required: The geographic location of the funder
      - `name` string, required
      - `alt-names` string[], required: Other names this funder may be identified with
      - `uri` string, required
      - `replaces` string[], required
      - `replaced-by` string[], required
      - `tokens` string[], required

---

[API](https://skmtc.dev/crossref/apis/crossref-rest-api.md) - [All operations](https://skmtc.dev/crossref/apis/crossref-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/crossref/apis/crossref-rest-api/revisions/3d27fa72d31a?raw)
