eCFR (Independent Publisher) (Preview)
The US Code of federal regulations, regulation metadata and point-in-time regulation versions. Made available via the Government Publishing Office (GPO).
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Dan Romano |
| URL | https://developments.substack.com |
| dan.romano@swolcat.com |
| Connector Metadata | |
|---|---|
| Publisher | Dan Romano |
| Website | https://www.ecfr.gov/reader-aids/ecfr-developer-resources |
| Privacy policy | https://www.ecfr.gov/reader-aids/government-policy-and-ofr-procedures/privacy |
| Categories | Business Management |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Get all CFR titles |
Returns a list of all current CFR titles, including their names, amendment history, and up-to-date status. |
| Get CFR Corrections |
Returns a list of historical corrections to the CFR, including Federal Register citations, titles, and hierarchy metadata. |
| Get CFR Corrections for a Specific Title |
Returns corrections for a specific CFR title, including Federal Register references and structural hierarchy metadata. |
| Get CFR Title Ancestry for a Given Date |
Returns the full regulatory hierarchy (title to section) for a specific title on a given date. |
| Get Content Versions for a Title |
Returns a list of historical content versions for a specific CFR title. |
| Get Full Regulation XML |
Returns full XML content for a given title on a specified CFR snapshot date. |
| Get List of CFR Agencies |
Returns all agencies that appear in the CFR, including children and title/chapter references. |
| Get search result counts by CFR hierarchy |
Returns the number of CFR search results distributed across hierarchical levels (title, chapter, part, etc.). |
| Search CFR results |
Search CFR sections by keyword and filter by date or other criteria. |
Get all CFR titles
Returns a list of all current CFR titles, including their names, amendment history, and up-to-date status.
Returns
- Body
- CfrTitlesResponse
Get CFR Corrections
Returns a list of historical corrections to the CFR, including Federal Register citations, titles, and hierarchy metadata.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Snapshot date
|
date | string |
Return corrections published as of a given date (yyyy-mm-dd) |
|
|
CFR Title Number
|
title | integer |
Limit results to a specific CFR title number |
|
|
Correction Effective Date
|
error_corrected_date | string |
Limit results to corrections with a given correction effective date (yyyy-mm-dd) |
Returns
- Body
- CorrectionResponse
Get CFR Corrections for a Specific Title
Returns corrections for a specific CFR title, including Federal Register references and structural hierarchy metadata.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
CFR Title Number
|
title | True | integer |
The CFR title number (e.g., 6, 7, 22) |
Returns
- Body
- CorrectionResponse
Get CFR Title Ancestry for a Given Date
Returns the full regulatory hierarchy (title to section) for a specific title on a given date.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Date
|
date | True | string |
The snapshot date to retrieve ancestry for (YYYY-MM-DD) |
|
CFR Title
|
title | True | string |
The CFR Title number (e.g., 2, 22, 50) |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
ancestry
|
ancestry | array of AncestryItem |
Get Content Versions for a Title
Returns a list of historical content versions for a specific CFR title.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
CFR Title
|
title | True | string |
The CFR Title number (e.g., 2, 22, 50) |
|
Issue Date On
|
issue_date[on] | string |
Return content added exactly on this date (YYYY-MM-DD) |
|
|
Issue Date Before or On
|
issue_date[lte] | string |
Return content added on or before this date (YYYY-MM-DD) |
|
|
Issue Date After or On
|
issue_date[gte] | string |
Return content added on or after this date (YYYY-MM-DD) |
|
|
Subtitle
|
subtitle | string |
Uppercase subtitle letter (e.g., 'A', 'B') |
|
|
Chapter
|
chapter | string |
Roman numerals or digits for the chapter (e.g., 'I', '2') |
|
|
Subchapter
|
subchapter | string |
Subchapter code (e.g., 'A', 'B', with optional dash or underscore) |
|
|
Part
|
part | string |
CFR part identifier (e.g., '3474') |
|
|
Subpart
|
subpart | string |
Subpart code (e.g., 'B') |
|
|
Section
|
section | string |
CFR section (e.g., '3474.20') |
|
|
Appendix
|
appendix | string |
Appendix reference (e.g., 'App. A') |
Returns
Get Full Regulation XML
Returns full XML content for a given title on a specified CFR snapshot date.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Snapshot Date
|
date | True | string |
Date of the CFR version (e.g., 2025-05-16) |
|
CFR Title
|
title | True | string |
Title number of the CFR (e.g., 21) |
|
Subtitle
|
subtitle | string |
Subtitle of the CFR structure |
|
|
Chapter
|
chapter | string |
Chapter of the CFR structure |
|
|
Subchapter
|
subchapter | string |
Subchapter of the CFR structure |
|
|
Part
|
part | string |
Part of the CFR structure |
|
|
Subpart
|
subpart | string |
Subpart of the CFR structure |
|
|
Section
|
section | string |
Section of the CFR structure |
|
|
Appendix
|
appendix | string |
Appendix of the CFR structure |
Returns
- response
- file
Get List of CFR Agencies
Returns all agencies that appear in the CFR, including children and title/chapter references.
Returns
- Body
- AgencyResponse
Get search result counts by CFR hierarchy
Returns the number of CFR search results distributed across hierarchical levels (title, chapter, part, etc.).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Search query
|
query | True | string |
The keyword or phrase to search for in the CFR database. |
|
Filter by agency slugs
|
agency_slugs | string |
Comma-separated list of agency slugs (e.g., "epa,doe,faa"). |
|
|
Snapshot date
|
date | date |
Limit results to content present on this date (YYYY-MM-DD). |
|
|
Modified after date
|
last_modified_after | date |
Limit results to content modified after this date (YYYY-MM-DD). |
|
|
Modified on or after
|
last_modified_on_or_after | date |
Limit results to content modified on or after this date (YYYY-MM-DD). |
|
|
Modified before date
|
last_modified_before | date |
Limit results to content modified before this date (YYYY-MM-DD). |
|
|
Modified on or before
|
last_modified_on_or_before | date |
Limit results to content modified on or before this date (YYYY-MM-DD). |
Returns
Search CFR results
Search CFR sections by keyword and filter by date or other criteria.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Search query
|
query | True | string |
The search term to query for in CFR content. |
|
Modified after
|
last_modified_on_or_after | date |
Return only results modified on or after this date (YYYY-MM-DD). |
|
|
Results per page
|
per_page | integer |
Number of results per page (default is 20). |
|
|
Page number
|
page | integer |
The page number to retrieve. |
|
|
Sort order
|
order | string |
Sort results by relevance or date. |
|
|
Pagination mode
|
paginate_by | string |
Method of pagination. Must be 'results'. |
Returns
Definitions
AncestryItem
| Name | Path | Type | Description |
|---|---|---|---|
|
type
|
type | string | |
|
label
|
label | string | |
|
label_level
|
label_level | string | |
|
label_description
|
label_description | string | |
|
identifier
|
identifier | string | |
|
reserved
|
reserved | boolean | |
|
section_range
|
section_range | string |
ContentVersionsResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
content_versions
|
content_versions | array of object | |
|
date
|
content_versions.date | string | |
|
amendment_date
|
content_versions.amendment_date | string | |
|
issue_date
|
content_versions.issue_date | string | |
|
identifier
|
content_versions.identifier | string | |
|
name
|
content_versions.name | string | |
|
part
|
content_versions.part | string | |
|
subpart
|
content_versions.subpart | string | |
|
title
|
content_versions.title | string | |
|
type
|
content_versions.type | string | |
|
substantive
|
content_versions.substantive | boolean | |
|
removed
|
content_versions.removed | boolean | |
|
title
|
meta.title | string | |
|
result_count
|
meta.result_count | string | |
|
lte
|
meta.issue_date.lte | string | |
|
gte
|
meta.issue_date.gte | string | |
|
latest_amendment_date
|
meta.latest_amendment_date | string | |
|
latest_issue_date
|
meta.latest_issue_date | string |
CfrTitle
| Name | Path | Type | Description |
|---|---|---|---|
|
number
|
number | number | |
|
name
|
name | string | |
|
latest_amended_on
|
latest_amended_on | string | |
|
latest_issue_date
|
latest_issue_date | string | |
|
up_to_date_as_of
|
up_to_date_as_of | string | |
|
reserved
|
reserved | boolean |
CfrTitlesMeta
| Name | Path | Type | Description |
|---|---|---|---|
|
date
|
date | string | |
|
import_in_progress
|
import_in_progress | boolean |
CfrTitlesResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
titles
|
titles | array of CfrTitle | |
|
meta
|
meta | CfrTitlesMeta |
AgencyResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
agencies
|
agencies | array of Agency |
AgencyReference
| Name | Path | Type | Description |
|---|---|---|---|
|
title
|
title | integer |
CFR title number |
|
chapter
|
chapter | string |
CFR chapter designation |
Agency
| Name | Path | Type | Description |
|---|---|---|---|
|
name
|
name | string | |
|
short_name
|
short_name | string | |
|
display_name
|
display_name | string | |
|
sortable_name
|
sortable_name | string | |
|
slug
|
slug | string | |
|
cfr_references
|
cfr_references | array of AgencyReference | |
|
children
|
children | array of Agency |
CorrectionReferenceHierarchy
| Name | Path | Type | Description |
|---|---|---|---|
|
title
|
title | string | |
|
subtitle
|
subtitle | string | |
|
chapter
|
chapter | string | |
|
part
|
part | string | |
|
subpart
|
subpart | string | |
|
section
|
section | string |
CorrectionReference
| Name | Path | Type | Description |
|---|---|---|---|
|
cfr_reference
|
cfr_reference | string | |
|
hierarchy
|
hierarchy | CorrectionReferenceHierarchy |
Correction
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | number | |
|
cfr_references
|
cfr_references | array of CorrectionReference | |
|
corrective_action
|
corrective_action | string | |
|
error_corrected
|
error_corrected | string | |
|
error_occurred
|
error_occurred | string | |
|
fr_citation
|
fr_citation | string | |
|
position
|
position | number | |
|
display_in_toc
|
display_in_toc | boolean | |
|
title
|
title | number | |
|
year
|
year | number | |
|
last_modified
|
last_modified | string |
CorrectionResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
ecfr_corrections
|
ecfr_corrections | array of Correction |
SearchResultsResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
starts_on
|
results.starts_on | string | |
|
ends_on
|
results.ends_on | string | |
|
type
|
results.type | string | |
|
hierarchy
|
results.hierarchy | object | |
|
hierarchy_headings
|
results.hierarchy_headings | object | |
|
headings
|
results.headings | object | |
|
full_text_excerpt
|
results.full_text_excerpt | string | |
|
|
results.score | float | |
|
structure_index
|
results.structure_index | number | |
|
reserved
|
results.reserved | boolean | |
|
removed
|
results.removed | boolean | |
|
change_types
|
results.change_types | array of string | |
|
current_page
|
meta.current_page | number | |
|
total_pages
|
meta.total_pages | number | |
|
total_count
|
meta.total_count | number | |
|
max_score
|
meta.max_score | float | |
|
description
|
meta.description | string |
HierarchyCountResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
value
|
count.value | number | |
|
relation
|
count.relation | string | |
|
max_score
|
max_score | float | |
|
shown_count
|
shown_count | number | |
|
children
|
children | array of HierarchyNode |
HierarchyNode
| Name | Path | Type | Description |
|---|---|---|---|
|
level
|
level | string | |
|
hierarchy
|
hierarchy | string | |
|
hierarchy_heading
|
hierarchy_heading | string | |
|
heading
|
heading | string | |
|
structure_index
|
structure_index | number | |
|
count
|
count | integer | |
|
max_score
|
max_score | float | |
|
children
|
children | array of object | |
|
level
|
children.level | string | |
|
hierarchy
|
children.hierarchy | string | |
|
hierarchy_heading
|
children.hierarchy_heading | string | |
|
heading
|
children.heading | string | |
|
structure_index
|
children.structure_index | number | |
|
count
|
children.count | integer | |
|
max_score
|
children.max_score | float | |
|
children
|
children.children | array of object | |
|
level
|
children.children.level | string | |
|
hierarchy
|
children.children.hierarchy | string | |
|
hierarchy_heading
|
children.children.hierarchy_heading | string | |
|
heading
|
children.children.heading | string | |
|
structure_index
|
children.children.structure_index | number | |
|
count
|
children.children.count | float | |
|
max_score
|
children.children.max_score | float |
file
This is the basic data type 'file'.