{"uid":"cap_RUWqynOX0AyGplL7-FQsr","slug":"bnm-data-shop-stb-board-decisions-261e2740","name":"BNM Data Shop – STB Board Decisions","description":"Official public data as JSON. Unpaid paid routes return HTTP 402.","url":"https://ticks.bnm.farm/stb-decisions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1sVR7HfYvQn6xD3FyaGfD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest Surface Transportation Board (STB) official board decisions as structured JSON, including docket numbers, decision types, deciding body, and PDF source links.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Monitor new STB trackage rights rulings","prompt":"Check the BNM Data Shop STB decisions feed and tell me if any new trackage rights decisions were issued today, including the docket numbers and which railroads are involved."},{"title":"Legal research on recent railroad decisions","prompt":"I'm researching recent Surface Transportation Board rulings — can you fetch the latest STB board decisions and list each one with its docket number, deciding body, and a link to the official PDF?"},{"title":"Regulatory compliance alert for rail operators","prompt":"Pull the most recent STB board decisions and flag any that involve Union Pacific or BNSF, including the decision type and date, so I can review them for compliance implications."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:46:54.355Z","isFirstParty":false,"canonicalSlug":"bnm-data-shop-stb-board-decisions-261e2740"}