> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# census-bureau

> Census Bureau API

**Server path:** `/census-bureau` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                              | Description                                           |
| --------------------------------------------------------------------------------- | ----------------------------------------------------- |
| [`census_bureau_fetch_aggregate_data`](#census_bureau_fetch_aggregate_data)       | Fetch aggregate data from a Census dataset            |
| [`census_bureau_fetch_dataset_geography`](#census_bureau_fetch_dataset_geography) | Get available geography levels for a dataset          |
| [`census_bureau_list_datasets`](#census_bureau_list_datasets)                     | List available Census Bureau datasets                 |
| [`census_bureau_resolve_geography_fips`](#census_bureau_resolve_geography_fips)   | Look up variable definitions and FIPS geography codes |

***

## census\_bureau\_fetch\_aggregate\_data

Fetch aggregate data from a Census dataset

**Parameters:**

| Parameter       | Type   | Required | Default | Description                                                                                                                                                                       |
| --------------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `year`          | string | Yes      | —       | Vintage year of the dataset (e.g. 2022, 2020, 2010)                                                                                                                               |
| `dataset_group` | string | Yes      | —       | Dataset group (e.g. 'acs' for American Community Survey, 'dec' for Decennial Census, 'pep' for Population Estimates)                                                              |
| `dataset_name`  | string | Yes      | —       | Dataset name within the group (e.g. 'acs5' for ACS 5-Year, 'acs1' for ACS 1-Year, 'pl' for PL 94-171, 'dhc' for DHC)                                                              |
| `get`           | string | Yes      | —       | Comma-separated list of variable names to retrieve (e.g. 'NAME,B01001\_001E' for geography name and total population). Use 'group(B01001)' to get all variables in a group.       |
| `for`           | string | Yes      | —       | Geography level and optional FIPS code to query (e.g. 'state:*' for all states, 'county:*' for all counties, 'state:06' for California, 'tract:\*' for all tracts)                |
| `in`            | string | No       | —       | Parent geography filter to narrow results (e.g. 'state:06' when querying counties in California, 'state:06+county:001' when querying tracts). Required for sub-state geographies. |
| `UCGID`         | string | No       | —       | Uniform Census Geography Identifier for precise geographic selection (alternative to for/in)                                                                                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "year": {
        "type": "string",
        "description": "Vintage year of the dataset (e.g. 2022, 2020, 2010)"
      },
      "dataset_group": {
        "type": "string",
        "description": "Dataset group (e.g. 'acs' for American Community Survey, 'dec' for Decennial Census, 'pep' for Population Estimates)"
      },
      "dataset_name": {
        "type": "string",
        "description": "Dataset name within the group (e.g. 'acs5' for ACS 5-Year, 'acs1' for ACS 1-Year, 'pl' for PL 94-171, 'dhc' for DHC)"
      },
      "get": {
        "type": "string",
        "description": "Comma-separated list of variable names to retrieve (e.g. 'NAME,B01001_001E' for geography name and total population). Use 'group(B01001)' to get all variables in a group."
      },
      "for": {
        "type": "string",
        "description": "Geography level and optional FIPS code to query (e.g. 'state:*' for all states, 'county:*' for all counties, 'state:06' for California, 'tract:*' for all tracts)"
      },
      "in": {
        "type": "string",
        "description": "Parent geography filter to narrow results (e.g. 'state:06' when querying counties in California, 'state:06+county:001' when querying tracts). Required for sub-state geographies."
      },
      "UCGID": {
        "type": "string",
        "description": "Uniform Census Geography Identifier for precise geographic selection (alternative to for/in)"
      }
    },
    "required": [
      "PCID",
      "year",
      "dataset_group",
      "dataset_name",
      "get",
      "for"
    ]
  }
  ```
</Expandable>

***

## census\_bureau\_fetch\_dataset\_geography

Get available geography levels for a dataset

**Parameters:**

| Parameter       | Type   | Required | Default | Description                                                                                                          |
| --------------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| `year`          | string | Yes      | —       | Vintage year of the dataset (e.g. 2022, 2020, 2010)                                                                  |
| `dataset_group` | string | Yes      | —       | Dataset group (e.g. 'acs' for American Community Survey, 'dec' for Decennial Census, 'pep' for Population Estimates) |
| `dataset_name`  | string | Yes      | —       | Dataset name within the group (e.g. 'acs5' for ACS 5-Year, 'acs1' for ACS 1-Year, 'pl' for PL 94-171, 'dhc' for DHC) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "year": {
        "type": "string",
        "description": "Vintage year of the dataset (e.g. 2022, 2020, 2010)"
      },
      "dataset_group": {
        "type": "string",
        "description": "Dataset group (e.g. 'acs' for American Community Survey, 'dec' for Decennial Census, 'pep' for Population Estimates)"
      },
      "dataset_name": {
        "type": "string",
        "description": "Dataset name within the group (e.g. 'acs5' for ACS 5-Year, 'acs1' for ACS 1-Year, 'pl' for PL 94-171, 'dhc' for DHC)"
      }
    },
    "required": [
      "PCID",
      "year",
      "dataset_group",
      "dataset_name"
    ]
  }
  ```
</Expandable>

***

## census\_bureau\_list\_datasets

List available Census Bureau datasets

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## census\_bureau\_resolve\_geography\_fips

Look up variable definitions and FIPS geography codes

**Parameters:**

| Parameter       | Type   | Required | Default | Description                                                                          |
| --------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------ |
| `year`          | string | Yes      | —       | Vintage year of the dataset (e.g. 2022, 2020, 2010)                                  |
| `dataset_group` | string | Yes      | —       | Dataset group (e.g. 'acs' for American Community Survey, 'dec' for Decennial Census) |
| `dataset_name`  | string | Yes      | —       | Dataset name within the group (e.g. 'acs5' for ACS 5-Year)                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "year": {
        "type": "string",
        "description": "Vintage year of the dataset (e.g. 2022, 2020, 2010)"
      },
      "dataset_group": {
        "type": "string",
        "description": "Dataset group (e.g. 'acs' for American Community Survey, 'dec' for Decennial Census)"
      },
      "dataset_name": {
        "type": "string",
        "description": "Dataset name within the group (e.g. 'acs5' for ACS 5-Year)"
      }
    },
    "required": [
      "PCID",
      "year",
      "dataset_group",
      "dataset_name"
    ]
  }
  ```
</Expandable>