{"openapi":"3.0.3","info":{"title":"Beehive AI Engine — public-record data API","description":"SEC EDGAR filing metadata, FDA drug approvals, and Utah planning-commission notices. Full datasets require a validated API key. Standard x402 v2 payments, when configured, are available only on the Utah land feed and its /x402 alias. Public transaction hashes and direct transfers do not unlock data.","version":"6.0.0","contact":{"name":"Grant Starkman","email":"grant.starkman@gmail.com","url":"https://engine.beehivewebstudio.com"}},"servers":[{"url":"https://engine.beehivewebstudio.com","description":"Beehive data API"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"A validated paid API-license key."},"x402Payment":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"Base64-encoded x402 v2 signed payment payload obtained by answering the resource PAYMENT-REQUIRED challenge."}}},"paths":{"/sec-insider/{ticker}":{"get":{"summary":"Recent SEC EDGAR Form 4 filing metadata for a tracked issuer","description":"Issuer, CIK, filing date, accession number, and document URL from the SEC submissions API. Reporting-person, share, and price fields are not parsed from the filing document and are returned as null.","security":[{"apiKey":[]}],"parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Source-backed data returned for a validated API key."},"402":{"description":"Payment required: obtain an API license and provide X-API-Key. Standard x402 is not enabled for this resource."},"503":{"description":"The data source is temporarily unavailable."}}}},"/fda-approvals":{"get":{"summary":"Recent FDA drug approvals","description":"Records from the openFDA drugsfda API: sponsor, brand/generic name, dosage form, route, and approval date.","security":[{"apiKey":[]}],"responses":{"200":{"description":"Source-backed data returned for a validated API key."},"402":{"description":"Payment required: obtain an API license and provide X-API-Key. Standard x402 is not enabled for this resource."},"503":{"description":"The data source is temporarily unavailable."}}}},"/utah-land":{"get":{"summary":"Utah County land feed HTML sample","description":"A free sample of already-heard planning-commission items from the currently ingested cities. Upcoming items and the full structured feed are available from GET /v1/utah-land.","responses":{"200":{"description":"HTML page with up to 10 sample records and the number of upcoming hearings."},"503":{"description":"The data source is temporarily unavailable."}}}},"/v1/utah-land":{"get":{"summary":"Utah County planning-commission hearing items (JSON, paywalled)","description":"Structured hearing items parsed from official Utah PMN notices, with source links and extraction provenance. Coverage depends on the records currently ingested; the response reports its actual cities and record count. Where present in a notice, fields include applicant, action type, current/proposed zoning, address, scale, file number, staff contact, hearing date, and verbatim source evidence. Unknown values remain empty. Unauthenticated requests receive a free sample of already-heard items inside a 402 response. A successful GET costs 0.01 USDC on Base using standard x402 v2. Decode the PAYMENT-REQUIRED header, sign its authorization with an x402 client, and retry with PAYMENT-SIGNATURE. The settlement receipt is returned in PAYMENT-RESPONSE. A validated X-API-Key also grants access. Signed payments are accepted only on GET. If a settlement returns 503, retain the same payment authorization; do not create a new payment while its outcome is unresolved.","security":[{"apiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"city","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80},"description":"Exact city-name filter. Available cities are reported by the current feed."},{"name":"dedupe","in":"query","required":false,"schema":{"type":"string","enum":["true","false","1","0"]},"description":"Collapse repeated hearing records per project."}],"responses":{"200":{"description":"Full feed after validated API-key access or successful standard payment settlement.","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement response for a successful machine payment.","schema":{"type":"string"}}}},"400":{"description":"Invalid query parameters. No payment attempted."},"402":{"description":"Payment required. Use the standard x402 challenge or a valid API key.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 requirements, including the accepted network, asset, amount, and recipient.","schema":{"type":"string"}}}},"404":{"description":"No records are available for this query. No payment attempted."},"405":{"description":"Signed payments require GET; no payment was attempted for the unsupported method."},"503":{"description":"Data/payment service unavailable or settlement outcome unresolved. Do not create another payment while a submitted authorization remains unresolved."}},"x-x402":{"available":true,"canonical_resource":"https://engine.beehivewebstudio.com/v1/utah-land","price_per_request_usdc":"0.01","requirements":{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x055ab9BE224bc906dB503557D71aA2eF6f502507","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}}}},"/v1/utah-land/x402":{"get":{"summary":"Alias of the Utah County planning-commission JSON feed","description":"Structured hearing items parsed from official Utah PMN notices, with source links and extraction provenance. Coverage depends on the records currently ingested; the response reports its actual cities and record count. Where present in a notice, fields include applicant, action type, current/proposed zoning, address, scale, file number, staff contact, hearing date, and verbatim source evidence. Unknown values remain empty. Unauthenticated requests receive a free sample of already-heard items inside a 402 response. A successful GET costs 0.01 USDC on Base using standard x402 v2. Decode the PAYMENT-REQUIRED header, sign its authorization with an x402 client, and retry with PAYMENT-SIGNATURE. The settlement receipt is returned in PAYMENT-RESPONSE. A validated X-API-Key also grants access. Signed payments are accepted only on GET. If a settlement returns 503, retain the same payment authorization; do not create a new payment while its outcome is unresolved.","security":[{"apiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"city","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80},"description":"Exact city-name filter. Available cities are reported by the current feed."},{"name":"dedupe","in":"query","required":false,"schema":{"type":"string","enum":["true","false","1","0"]},"description":"Collapse repeated hearing records per project."}],"responses":{"200":{"description":"Full feed after validated API-key access or successful standard payment settlement.","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement response for a successful machine payment.","schema":{"type":"string"}}}},"400":{"description":"Invalid query parameters. No payment attempted."},"402":{"description":"Payment required. Use the standard x402 challenge or a valid API key.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 requirements, including the accepted network, asset, amount, and recipient.","schema":{"type":"string"}}}},"404":{"description":"No records are available for this query. No payment attempted."},"405":{"description":"Signed payments require GET; no payment was attempted for the unsupported method."},"503":{"description":"Data/payment service unavailable or settlement outcome unresolved. Do not create another payment while a submitted authorization remains unresolved."}},"x-x402":{"available":true,"canonical_resource":"https://engine.beehivewebstudio.com/v1/utah-land","price_per_request_usdc":"0.01","requirements":{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x055ab9BE224bc906dB503557D71aA2eF6f502507","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}}}},"/vineyard-pc-notices":{"get":{"summary":"Vineyard Planning Commission notice extracts","description":"Full text of official Utah PMN agenda PDFs extracted with AWS Textract and served with provenance.","security":[{"apiKey":[]}],"responses":{"200":{"description":"Source-backed data returned for a validated API key."},"402":{"description":"Payment required: obtain an API license and provide X-API-Key. Standard x402 is not enabled for this resource."},"503":{"description":"The data source is temporarily unavailable."}}}},"/vineyard-pc-notices/{datasetId}":{"get":{"summary":"One Vineyard Planning Commission notice extract","security":[{"apiKey":[]}],"parameters":[{"name":"datasetId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Source-backed data returned for a validated API key."},"402":{"description":"Payment required: obtain an API license and provide X-API-Key. Standard x402 is not enabled for this resource."},"404":{"description":"Unknown dataset ID."},"503":{"description":"The data source is temporarily unavailable."}}}},"/.well-known/x402":{"get":{"summary":"Payment capabilities and configured standard x402 resource","responses":{"200":{"description":"Current payment capabilities. Only configured standard payment requirements are advertised."}}}},"/checkout":{"get":{"summary":"Stripe hosted checkout for an API license","responses":{"302":{"description":"Redirects to hosted checkout."}}}}}}