# BNM Data Shop – PHMSA Enforcement Orders

> BNM Data Shop – PHMSA Enforcement Orders is a paid API for AI agents from ticks.bnm.farm, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-20).

Returns structured JSON records of PHMSA (Pipeline and Hazardous Materials Safety Administration) enforcement orders and corrective action orders issued to pipeline operators.

## Facts

- Endpoint: GET https://ticks.bnm.farm/phmsa-orders?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bnm-data-shop-phmsa-enforcement-orders-58f41342
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NdO_8LCX7H3I_S-RVfpEj

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 bnm-data-shop-phmsa-enforcement-orders-58f41342
```

Example prompt: Pull the latest PHMSA enforcement and corrective action orders from the BNM Data Shop so I can see which pipeline operators have been cited recently.

## When to prefer this

Choose this endpoint when you need PHMSA enforcement and corrective action order data in structured JSON format without scraping the PHMSA PRIMIS portal yourself. It is preferable when building compliance dashboards, performing regulatory due diligence on pipeline operators, or automating alerts for new enforcement actions, and when paying $0.05 USDC per call via x402 is acceptable.

## Known failure modes

- HTTP 402 Payment Required if valid x402 payment header is not included
- Empty records array if no new enforcement orders have been published
- Stale `asOf` date if upstream PHMSA source has not been refreshed recently
- Network timeout if upstream PHMSA primis portal is unavailable

## How this service works

Official public data as JSON. Unpaid paid routes return HTTP 402.

## Output

A JSON object containing: a boolean `ok` status, the product name (`phmsa-enforcement-order-bodies`), an `asOf` date, a `fetchedAt` timestamp, the source URL, a `recordCount` integer, a `records` array (each with id, url, date, firm name, and type), and a `cards` array with richer fields including an order body excerpt, institution name, and source PDF URL.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "schema": {
     "type": "object"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "ok",
   "product",
   "status",
   "fetchedAt",
   "asOf",
   "source",
   "recordCount",
   "records",
   "cards"
  ],
  "properties": {
   "ok": {
    "type": "boolean"
   },
   "asOf": {
    "type": "string"
   },
   "cards": {
    "type": "array",
    "items": {
     "type": "object"
    }
   },
   "source": {
    "type": "string"
   },
   "status": {
    "type": "string"
   },
   "product": {
    "type": "string"
   },
   "records": {
    "type": "array",
    "items": {
     "type": "object"
    }
   },
   "fetchedAt": {
    "type": "string"
   },
   "recordCount": {
    "type": "integer"
   }
  }
 },
 "example": {
  "ok": true,
  "asOf": "2026-08-03",
  "cards": [
   {
    "id": "32026023CAO-corrective-action-order",
    "cpf": "32026023CAO",
    "body": "This teaser is not an official PHMSA order body. Amoco Oil Co Corrective Action Order excerpt.",
    "date": "2026-08-03",
    "sourceUrl": "https://primis.phmsa.dot.gov/enforcement-documents/32026023CAO/32026023CAO_Corrective%20Action%20Order_08032026_(26-379109).pdf",
    "institution": "AMOCO OIL CO"
   }
  ],
  "source": "https://primis.phmsa.dot.gov/enforcement-documents/",
  "status": "ok",
  "product": "phmsa-enforcement-order-bodies",
  "records": [
   {
    "id": "32026023CAO-corrective-action-order",
    "url": "https://primis.phmsa.dot.gov/enforcement-documents/32026023CAO/32026023CAO_Corrective%20Action%20Order_08032026_(26-379109).pdf",
    "date": "2026-08-03",
    "firm": "AMOCO OIL CO",
    "type": "phmsa-orders"
   }
  ],
  "fetchedAt": "2026-08-31T22:00:00.000Z",
  "recordCount": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bnm-data-shop-phmsa-enforcement-orders-58f41342/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ticks.bnm.farm](https://www.zero.xyz/host/ticks.bnm.farm/llms.txt)