# Insurance Department Bulletins Lookup

> Insurance Department Bulletins Lookup is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Retrieves recent Department of Insurance bulletins, circular letters, and notices for a given US state, normalized and filterable by keyword and year.

## Facts

- Endpoint: GET https://payai.agentstools.dev/insurance/bulletins
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/insurance-department-bulletins-lookup-e123ce3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dxfqKbql3ixem5Wfqp4EH

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 insurance-department-bulletins-lookup-e123ce3b
```

Example prompt: Can you pull the most recent Department of Insurance bulletins for California, filtering for anything mentioning 'rate filing' from 2022 onward — give me up to 50 results?

## When to prefer this

Use this endpoint when you need to programmatically retrieve and normalize official US state Department of Insurance bulletins, circular letters, or notices — especially when filtering by keyword or year range. Prefer this over manual web scraping of DOI sites, which vary in structure. Best suited for compliance monitoring, regulatory research, and insurance industry due diligence workflows where structured, normalized output is needed.

## Known failure modes

- State not in curated subset — returns empty results or error indicating unsupported state
- No bulletins match keyword/year filters — returns empty list
- Partial failure — upstream DOI source partially unreachable, returns subset of available bulletins
- Invalid state code — returns validation error
- Limit out of range (below 1 or above 100) — returns schema validation error

## How this service works

Recent Department of Insurance bulletins, circular letters and notices for a state, normalized to title, url, year and type with a linkback. Curated subset of reachable states, filterable by keyword and year, partial-on-failure.

## Output

Returns a list of normalized insurance department bulletin records, each containing the bulletin title, URL, publication year, bulletin type (e.g. circular letter, notice), and a linkback to the source. Results are partial on failure (returns whatever was successfully retrieved), up to the specified limit (default 25, max 100).

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Max items to return, default 25"
      },
      "state": {
       "type": "string",
       "description": "US state or territory name or 2-letter code, such as California or CA"
      },
      "keyword": {
       "type": "string",
       "description": "Optional keyword to filter bulletin titles"
      },
      "year_from": {
       "type": "integer",
       "description": "Only bulletins from this year onward"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/insurance-department-bulletins-lookup-e123ce3b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)