# US Regulation Counts

> US Regulation Counts is a paid API for AI agents from us-regulations.use.x402atlas.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-28).

Returns faceted counts of Federal Register documents matching a search query, grouped by agency, document type, year, quarter, month, topic, or section.

## Facts

- Endpoint: GET https://us-regulations.use.x402atlas.com/counts?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-regulation-counts-82471897
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UweVDBWRS9qzvYh0_Eywa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-regulation-counts-82471897
```

Example prompt: How many Federal Register documents mention 'artificial intelligence', broken down by agency? Search from 2020-01-01 to today and group by agency.

## When to prefer this

Use this endpoint when you need aggregate statistics or trend analysis over Federal Register documents rather than the documents themselves. Prefer it over the search endpoint when the goal is to count, compare, or visualize regulatory activity — for instance, determining which agencies regulate a topic, how rulemaking volume changed over time, or which document types dominate for a keyword. It is the right choice for dashboards, policy research, and compliance landscape assessments where counts matter more than individual document content.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Invalid facet enum value returns a 400 error
- Agency slug not found in registry returns zero-count buckets
- Date format not conforming to YYYY-MM-DD causes a parsing error
- cfr_part supplied without cfr_title returns a validation error
- More than 5 agency slugs in the agency parameter may be rejected
- Query returns no matches, resulting in empty buckets list with total=0

## How this service works

US federal regulation counts — how many Federal Register documents match a search, grouped by agency, document type, year, quarter, month, topic or section, with the same filters as the search. Use to see which agencies regulate a subject, how rulemaking activity moved over time, or which topics a term touches.

## Output

Returns a list of up to 50 buckets for the chosen facet dimension (e.g. agency slugs, years, document types, topics), each with a label and a document count, plus the total number of matching documents and metadata such as retrieval timestamp, applied filters, and any caveat notes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "rin": {
       "type": "string",
       "maxLength": 64
      },
      "type": {
       "type": "string",
       "maxLength": 60,
       "description": "Comma-separated of rule, proposed_rule, notice, presidential"
      },
      "facet": {
       "enum": [
        "agency",
        "type",
        "yearly",
        "quarterly",
        "monthly",
        "topic",
        "section"
       ],
       "type": "string",
       "default": "agency"
      },
      "query": {
       "type": "string",
       "maxLength": 200,
       "description": "Full-text search"
      },
      "since": {
       "type": "string",
       "format": "date",
       "description": "Published on or after, YYYY-MM-DD"
      },
      "until": {
       "type": "string",
       "format": "date",
       "description": "Published on or before, YYYY-MM-DD"
      },
      "agency": {
       "type": "string",
       "maxLength": 500,
       "description": "Comma-separated agency slugs, up to 5"
      },
      "docket": {
       "type": "string",
       "maxLength": 64
      },
      "cfr_part": {
       "type": "string",
       "maxLength": 9,
       "description": "Requires cfr_title"
      },
      "cfr_title": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      },
      "significant": {
       "type": "boolean"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "as_of",
      "source",
      "caveat",
      "modified",
      "query",
      "agency",
      "type",
      "since",
      "until",
      "facet",
      "total",
      "count",
      "buckets"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Present only on a sample or empty response"
      },
      "type": {
       "type": "array",
       "items"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-regulation-counts-82471897/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from us-regulations.use.x402atlas.com](https://www.zero.xyz/host/us-regulations.use.x402atlas.com/llms.txt)