{"openapi":"3.1.0","info":{"title":"AgentNative Data Exchange","version":"0.3.0","description":"Bounded public-data discovery, on-demand materialization, query, and entitlement API for software agents."},"servers":[{"url":"https://agentnative.dennery.ai"}],"paths":{"/health":{"get":{"operationId":"health","responses":{"200":{"description":"Process health"}}}},"/ready":{"get":{"operationId":"readiness","responses":{"200":{"description":"Database and billing dependencies ready"},"503":{"description":"A production dependency is unavailable"}}}},"/v1/catalog":{"get":{"operationId":"listDataProducts","responses":{"200":{"description":"Catalog"}}}},"/v1/datasets/search":{"get":{"operationId":"searchPublicDatasets","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Normalized search results"}}}},"/v1/sample/us-federal-register":{"get":{"operationId":"sampleFederalRegister","description":"A free regulatory briefing: aggregates over the latest 25 documents and three example records.","responses":{"200":{"description":"Free sample, deterministic insights, provenance, and upgrade path"},"429":{"description":"Free sample rate limit exceeded"}}}},"/v1/capabilities/request":{"post":{"operationId":"requestCapability","description":"Submit a structured missing-capability request for deduplication and autonomous build prioritization.","responses":{"202":{"description":"Capability demand accepted and ranked"},"400":{"description":"Invalid structured request"},"429":{"description":"Request rate limit exceeded"}}}},"/v1/materializations":{"post":{"operationId":"requestDatasetMaterialization","description":"Prioritize a discovered compatible dataset for detached ingestion. Idempotently returns a durable polling URL.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discovered_dataset_id":{"type":"string","pattern":"^disc_[a-f0-9]{24}$"}},"required":["discovered_dataset_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Dataset was already materialized"},"202":{"description":"Materialization queued or in progress"},"422":{"description":"No supported bounded distribution"},"429":{"description":"Request rate limit exceeded"}}}},"/v1/materializations/{job}":{"get":{"operationId":"getDatasetMaterialization","description":"Poll a requested ingestion job until it supplies sample and query URLs.","parameters":[{"name":"job","in":"path","required":true,"schema":{"type":"string","pattern":"^job_[a-f0-9]{24}$"}}],"responses":{"200":{"description":"Durable job state and completion links"},"404":{"description":"Requested materialization not found"},"429":{"description":"Status rate limit exceeded"}}}},"/v1/access/start":{"post":{"operationId":"startPaidAccess","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"string","enum":["pass","subscription"],"default":"pass"}},"additionalProperties":false}}}},"responses":{"402":{"description":"Owner checkout, one-time claim and Stripe email-verified manage_billing_url; $5 pass (250 queries, 30 days) or $5/month (2,000 queries per billing period)"},"502":{"description":"Stripe Checkout unavailable"},"503":{"description":"Billing unavailable"}}}},"/v1/access/claim/{claim}":{"post":{"operationId":"claimPaidAccess","parameters":[{"name":"claim","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"One-time bearer token issued"},"409":{"description":"Payment or entitlement pending"},"410":{"description":"Claim already redeemed"}}}},"/v1/query/us-federal-register":{"get":{"operationId":"queryFederalRegister","security":[{"bearerAuth":[]}],"parameters":[{"name":"$start","in":"query","schema":{"type":"string","format":"date"}},{"name":"$end","in":"query","schema":{"type":"string","format":"date"}},{"name":"$type","in":"query","schema":{"type":"string","enum":["NOTICE","PRORULE","RULE","PRESDOCU"]}},{"name":"$top","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}],"responses":{"200":{"description":"Normalized Federal Register documents"},"401":{"description":"Paid access required"},"429":{"description":"Rate limit exceeded"}}}},"/v1/warehouse":{"get":{"operationId":"listImportedDatasets","responses":{"200":{"description":"Published imported datasets with row counts"}}}},"/v1/sources":{"get":{"operationId":"listOfficialSources","responses":{"200":{"description":"Official source scopes, matched importers, discovery status, and publication coverage"}}}},"/v1/coverage":{"get":{"operationId":"getCoverageStatus","responses":{"200":{"description":"Current source discovery, materialization, queryable-row, queue, failure, and freshness coverage. court_sources lists up to court_sources_limit (100) enabled court sources with discovery status and dataset counts"}}}},"/v1/datasets/discovered":{"get":{"operationId":"searchDiscoveredDatasets","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":100}},{"name":"source","in":"query","schema":{"type":"string","maxLength":100}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}],"responses":{"200":{"description":"Durable discovered dataset catalog across synchronized sources"}}}},"/v1/warehouse/sample/{dataset}":{"get":{"operationId":"sampleImportedDataset","parameters":[{"name":"dataset","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Three normalized rows, deterministic summaries, and provenance"},"404":{"description":"Dataset not found"}}}},"/v1/warehouse/query/{dataset}":{"get":{"operationId":"queryImportedDataset","description":"Free preview without auth ($top to 25, $skip to 475, page.next_url cursor; exact-match filter needs bearer); bearer auth raises bounds ($top 100, $skip 5000, 120/min).","security":[{"bearerAuth":[]},{}],"parameters":[{"name":"dataset","in":"path","required":true,"schema":{"type":"string"}},{"name":"$top","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"$skip","in":"query","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}},{"name":"$filter_field","in":"query","schema":{"type":"string"}},{"name":"$filter_value","in":"query","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Normalized rows, summaries, provenance, paging cursor, and optional exact-match filtering"},"400":{"description":"Free bound exceeded"},"402":{"description":"Query allowance exhausted"},"429":{"description":"Rate limit exceeded"}}}},"/v1/warehouse/aggregate/{dataset}":{"get":{"operationId":"aggregateImportedDataset","description":"Free preview without auth (top 10 groups over up to 5,000 current rows); bearer auth raises bound to top 50 at 120/min.","security":[{"bearerAuth":[]},{}],"parameters":[{"name":"dataset","in":"path","required":true,"schema":{"type":"string"}},{"name":"group_by","in":"query","required":true,"schema":{"type":"string"}},{"name":"metric","in":"query","schema":{"type":"string","enum":["count","sum","avg","min","max"],"default":"count"}},{"name":"field","in":"query","schema":{"type":"string"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Ranked grouped values with record counts"},"400":{"description":"Free bound exceeded"},"402":{"description":"Query allowance exhausted"},"429":{"description":"Rate limit exceeded"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}