# BNM Data Shop – STB Board Decisions

> BNM Data Shop – STB Board Decisions 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 the latest Surface Transportation Board (STB) official board decisions as structured JSON, including docket numbers, decision types, deciding body, and PDF source links.

## Facts

- Endpoint: GET https://ticks.bnm.farm/stb-decisions?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-stb-board-decisions-261e2740
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RUWqynOX0AyGplL7-FQsr

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-stb-board-decisions-261e2740
```

Example prompt: Can you pull the latest official Surface Transportation Board decisions from BNM Data Shop and show me the docket numbers, decision types, and links to the PDFs?

## When to prefer this

Use this endpoint when you need structured, machine-readable access to official Surface Transportation Board decisions — especially for monitoring new rulings, legal research, regulatory compliance workflows involving US rail carriers, or building alerts around specific dockets. It is preferable to scraping stb.gov directly because it returns clean JSON with normalized fields (docket, decision type, deciding body, PDF link) rather than raw HTML or PDFs. Best suited for automated pipelines that need fresh STB data on demand at low cost ($0.05/call).

## Known failure modes

- HTTP 402 returned if payment is not included (unpaid route)
- Empty records array if no new decisions have been published for the queried period
- Stale 'asOf' date if STB has not published new decisions recently
- Network timeout or 5xx if the upstream STB source or BNM aggregator is unavailable
- Missing or malformed PDF source URLs if DCMS external storage changes structure

## 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 identifier ('stb-board-decision-bodies'), the source URL (stb.gov decisions page), the fetch timestamp ('fetchedAt'), the as-of date ('asOf'), a record count ('recordCount'), a 'records' array (each with id, url, date, firm/institution name, and type), and a 'cards' array (richer objects with title, docket, decisionId, decisionNo, decidingBody, decisionType, kind, body text, and sourceUrl pointing to the PDF on S3).

## 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-07-21",
  "cards": [
   {
    "id": "52932",
    "body": "SURFACE TRANSPORTATION BOARD. Docket No. FD 32760 (Sub-No. 46). Decision No. 16. Official STB Board Decision extracted from the DCMS PDF.",
    "date": "2026-07-21",
    "kind": "Board Decision",
    "title": "BNSF Railway Company—Terminal Trackage Rights—Kansas City Southern Railway Company and Union Pacific Railroad Company",
    "docket": "FD-32760-46",
    "sourceUrl": "https://dcms-external.s3.amazonaws.com/DCMS_External_PROD/1784658941212/52932.pdf",
    "decisionId": "52932",
    "decisionNo": "16",
    "institution": "BNSF Railway Company—Terminal Trackage Rights—Kansas City Southern Railway Company and Union Pacific Railroad Company",
    "decidingBody": "Entire Board",
    "decisionType": "Decision"
   }
  ],
  "source": "https://www.stb.gov/proceedings-actions/decisions/",
  "status": "ok",
  "product": "stb-board-decision-bodies",
  "records": [
   {
    "id": "52932",
    "url": "https://dcms-external.s3.amazonaws.com/DCMS_External_PROD/1784658941212/52932.pdf",
    "date": "2026-07-21",
    "firm": "BNSF Railway Company—Terminal Trackage Rights—Kansas City Southern Railway Company and Union Pacific Railroad Company",
    "type": "stb-decisions"
   }
  ],
  "fetchedAt": "2026-09-14T00:00:00.000Z",
  "recordCount": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bnm-data-shop-stb-board-decisions-261e2740/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)