---
title: "GET /v1/schedules/schedule_b/by_purpose/"
method: GET
path: "/v1/schedules/schedule_b/by_purpose/"
tags: ["disbursements"]
---

# GET /v1/schedules/schedule_b/by_purpose/

`GET /v1/schedules/schedule_b/by_purpose/`

## Request

- Base URL: `https://api.open.fec.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://api.open.fec.gov/v1/schedules/schedule_b/by_purpose/`
- Auth: API key in header `X-Api-Key` and API key in query parameter `api_key` and API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/fec/apis/openfec/docs/v1/schedules/schedule_b/by_purpose/get.ts> (a function with typed inputs; its response is checked against the schema)

Schedule B disbursements aggregated by disbursement purpose category. To avoid double counting,
memoed items are not included.
Purpose is a combination of transaction codes, category codes and disbursement description.
Inspect the `disbursement_purpose` sql function within the migrations for more details.

## Query parameters

- `page` integer
- `per_page` integer
- `cycle` integer[]
- `purpose` string[]
- `committee_id` string[]
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- ScheduleBByPurposePage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` ScheduleBByPurpose[]
    - `committee_id` string, required: A unique identifier assigned to each committee or filer registered with the FEC. In general a committee id begins with the letter C which is followed by eight digits.
    - `count` integer, nullable: Number of records making up the total.
    - `cycle` integer, required: Filter records to only those that were applicable to a given two-year period.The cycle begins with an odd year and is named for its ending, even year.
    - `memo_count` integer, nullable: Number of records making up the total.
    - `memo_total` number, nullable: Schedule B disbursements aggregated by memoed items only
    - `purpose` string, required: Purpose of the expenditure
    - `total` number

---

[API](https://skmtc.dev/fec/apis/openfec.md) - [All operations](https://skmtc.dev/fec/apis/openfec/llms.txt) - [OpenAPI document](https://skmtc.dev/fec/apis/openfec/revisions/d2eb3171e225?raw)