# BNM Data Shop – OALJ Decisions

> BNM Data Shop – OALJ 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 structured JSON records of U.S. Department of Labor Office of Administrative Law Judges (OALJ) decisions and orders extracted from official PDFs.

## Facts

- Endpoint: GET https://ticks.bnm.farm/oalj-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-oalj-decisions-3de87ab1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Khj1VuW-ss5cBxYEa3je

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-oalj-decisions-3de87ab1
```

Example prompt: Pull the latest U.S. Department of Labor OALJ decisions as JSON — I need the case numbers, parties involved, program codes, decision dates, and links to the original PDFs.

## When to prefer this

Choose this endpoint when you need structured, machine-readable OALJ decision data without scraping DOL PDFs yourself. Ideal for legal research tools, compliance monitoring, regulatory tracking pipelines, or any agent that needs DOL administrative law judge rulings as clean JSON with case metadata and source links. Prefer this over direct DOL scraping when you need reliable JSON output with minimal integration effort.

## Known failure modes

- HTTP 402 Payment Required if payment header is missing or insufficient (unpaid route)
- Empty records array if no decisions are currently published
- Stale data if upstream DOL source has not been updated
- Network timeout if upstream DOL PDF extraction is slow
- Invalid or malformed response if upstream oalj.dol.gov source 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, product identifier, fetch timestamp, data-as-of date, source URL, total record count, an array of `records` (each with id, URL, date, firm/parties, type), and an array of `cards` (enriched view with id, title, kind, program, ALJ number, case number, institution, date, body summary, 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-07-30",
  "cards": [
   {
    "id": "2026-spa-00001",
    "body": "U.S. Department of Labor. Office of Administrative Law Judges. OALJ No. 2026-SPA-00001. Official DOL OALJ Decision and Order extracted from the oalj.dol.gov PDF.",
    "date": "2026-07-30",
    "kind": "Order",
    "aljNo": "2026-SPA-00001",
    "board": "oalj",
    "title": "Order on Respondent's Motion to Dismiss",
    "caseNo": "2026-SPA-00001",
    "program": "SPA",
    "sourceUrl": "https://www.oalj.dol.gov/DECISIONS/ALJ/SPA/2026/McLaughlin_v_Troy_Construction_LL_2026SPA00001_(JUL_30_2026)_100012_CADEC_PD.PDF",
    "institution": "McLaughlin v. Troy Construction, LLC"
   }
  ],
  "source": "https://www.dol.gov/agencies/oalj/topics/information/DECISIONS",
  "status": "ok",
  "product": "oalj-decision-bodies",
  "records": [
   {
    "id": "2026-spa-00001",
    "url": "https://www.oalj.dol.gov/DECISIONS/ALJ/SPA/2026/McLaughlin_v_Troy_Construction_LL_2026SPA00001_(JUL_30_2026)_100012_CADEC_PD.PDF",
    "date": "2026-07-30",
    "firm": "McLaughlin v. Troy Construction, LLC",
    "type": "oalj-decisions"
   }
  ],
  "fetchedAt": "2026-09-15T00:00:00.000Z",
  "recordCount": 1
 }
}
```

## More

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