---
title: "GET /transactions"
method: GET
path: "/transactions"
tags: ["List"]
---

# GET /transactions

`GET /transactions`

Search for grant activity based on the criteria specified. Returns a maximum of 25 results.

## Query parameters

- `query` string
- `location` integer
- `geo_id_type` 'geonameid'
- `location_type` 'funder' | 'recipient' | 'area_served'
- `year` integer[]
- `subject` string[]
- `population` string[]
- `support` string[]
- `transaction` string[]
- `recip_id` string[]
- `funder_id` string[]
- `id_type` 'ein'
- `include_gov` 'yes' | 'no'
- `min_amt` integer
- `max_amt` integer
- `sort_by` 'funder_name' | 'recip_name' | 'year_issued' | 'amount' | 'count'
- `last_updated` string, date
- `sort_order` 'asc' | 'desc'
- `page` integer
- `format` 'json' | 'xml'
- `profile_levels` string

## Response `200`

Array of the grants' funder, recipient, grant amount and grant description that match the criteria searched.

- object
  - `meta` object
    - `code` integer — HTTP response status code.
    - `status` string — Description of the HTTP response status code.
    - `elapsed_time` string — Elapsed time of API call in milliseconds.
    - `time` string — Time of API call.
  - `data` object
    - `total_hits` integer — Total number of results returned
    - `num_pages` integer — Total number of pages returned
    - `rows` object[]
      - `funder_key` string — Unique identifier assigned to each organization awarding a transaction
      - `funder_profile_url` string — Funder or Grantmaker Foundation Directory profile link
      - `funder_name` string — Funder or Grantmaker name
      - `funder_city` string — Funder or Grantmaker city
      - `funder_state` string — Funder or Grantmaker state
      - `funder_country` string — Funder or Grantmaker country
      - `funder_type` string — Funder or Grantmaker type
      - `funder_zipcode` string — Funder or Grantmaker zip code
      - `funder_country_code` string — Funder or Grantmaker country ISO2 code
      - `funder_ein` string — Funder or Grantmaker IRS Employer Identification Number
      - `funder_gs_profile_update_level` string — Funder or Grantmaker seal level of transparency profile level
      - `recip_key` string — Unique identifier assigned to each organization awarded a transaction
      - `recip_name` string — Recipient name
      - `recip_city` string — Recipient city
      - `recip_state` string — Recipient state
      - `recip_country` string — Recipient country
      - `recip_zipcode` string — Recipient zip code
      - `recip_country_code` string — Recipient country ISO2 code
      - `recip_ein` string — Funder or Grantmaker IRS Employer Identification Number
      - `recip_seal_level` string — Deprecated
      - `recip_organization_code` string — Recipient organization code. Identifies the legal status and/or primary function of the organization.
      - `recip_organization_tran` string — Recipient organization code definition
      - `recip_gs_profile_link` string — Recipient GuideStar profile link
      - `recip_gs_profile_update_level` string — Recipient seal level of transparency profile level
      - `grant_key` string — Unique identifier assigned to each transaction
      - `amount_usd` number — Dollar value of grant awarded or authorized in USD
      - `grant_subject_code` string — Grant subject code. Candid assigns subject codes using the Philanthropy Classification System to represent the core activities and services supported by the grant.
      - `grant_subject_tran` string — Grant subject code description
      - `grant_population_code` string — Grant population code. Candid assigns subject codes using the Philanthropy Classification System to reflect the populations intended to be served by the grant.
      - `grant_population_tran` string — Grant population code definition
      - `grant_strategy_code` string — Grant support strategy code. Candid assigns subject codes using the Philanthropy Classification System to reflect the strategy or implementation approach being supported by the grant.
      - `grant_strategy_tran` string — Grant support strategy code definition
      - `grant_transaction_code` string — Grant transaction code. Candid assigns grant transaction codes using the Philanthropy Classification System to represent the type of award received.
      - `grant_transaction_tran` string — Grant transaction code definition
      - `grant_geo_area_code` string — Geonameid of the area served by the grant
      - `grant_geo_area_tran` string — Geonameid description of the area served by the grant
      - `year_issued` string — Year that grant was awarded or authorized (fiscal year end)
      - `grant_duration` string — Duration of grant period (in months)
      - `grant_description` string — Grant description
      - `last_updated` string — Date when the grant record was published or updated by candid

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — No Results Found
- `406` — Not Acceptable
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/candid/apis/rfpapi.md) · [All operations](https://skmtc.dev/candid/apis/rfpapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/candid/rfpapi/revisions/bb9133e46de6/schema)