{ "openapi": "3.1.0", "info": { "title": "nyc-evidence API", "version": "2026.10.25", "summary": "Verifiable legal evidence for AI agents and people: New York City sidewalk injuries and traffic accidents.", "description": "Research evidence, not legal advice. Every object has a canonical URL, a content hash, and trust metadata; uncertainty is reported with explicit statuses (VERIFIED, UNVERIFIED_CANDIDATE, INSUFFICIENT_EVIDENCE, CONFLICTING_AUTHORITY, TEMPORAL_UNCERTAINTY). Record reads are open. An evidence packet requires the access token from a paid checkout. See /docs for guides and /llms.txt for an agent-oriented index.", "license": { "name": "CC BY 4.0 (editorial data; statutes and court opinions are public domain)", "identifier": "CC-BY-4.0" } }, "servers": [ { "url": "https://agents.newyorkeverydaylawreference.com" } ], "externalDocs": { "url": "https://agents.newyorkeverydaylawreference.com/docs", "description": "Guides" }, "tags": [ { "name": "Evidence", "description": "Canonical evidence objects" }, { "name": "Research", "description": "Search and evidence packets" }, { "name": "Citations", "description": "Checking citations handed over by another agent" }, { "name": "Discovery", "description": "Machine-readable service descriptions" } ], "paths": { "/search": { "get": { "operationId": "searchEvidence", "summary": "Search evidence by words and topics", "tags": [ "Research" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Search text", "schema": { "type": "string", "minLength": 1, "maxLength": 500 } }, { "name": "jurisdiction", "in": "query", "required": false, "description": "Jurisdiction; parents are included", "schema": { "type": "string", "default": "us-ny-nyc" } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "type", "in": "query", "required": false, "description": "Limit to one record type", "schema": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] } }, { "name": "limit", "in": "query", "required": false, "description": "Results per page", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the previous page", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Ranked results with the interpretation used", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchResponse" } } } }, "400": { "description": "Invalid request (code INVALID_REQUEST)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/proposition/{id}": { "get": { "operationId": "getProposition", "summary": "The current proposition", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^prop_" } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The proposition", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Proposition" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/proposition/{id}/v/{n}": { "get": { "operationId": "getPropositionVersion", "summary": "A specific editorial version of a proposition (immutable)", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^prop_" } }, { "name": "n", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The proposition", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Proposition" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/authority/{id}": { "get": { "operationId": "getAuthority", "summary": "The current authority", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^auth_" } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The authority", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Authority" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/authority/{id}/v/{n}": { "get": { "operationId": "getAuthorityVersion", "summary": "A specific editorial version of a authority (immutable)", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^auth_" } }, { "name": "n", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The authority", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Authority" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/case/{id}": { "get": { "operationId": "getCase", "summary": "The current case", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^case_" } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The case", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Case" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/case/{id}/v/{n}": { "get": { "operationId": "getCaseVersion", "summary": "A specific editorial version of a case (immutable)", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^case_" } }, { "name": "n", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The case", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Case" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/source/{id}": { "get": { "operationId": "getSource", "summary": "The current source", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^src_" } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The source", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Source" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/source/{id}/v/{n}": { "get": { "operationId": "getSourceVersion", "summary": "A specific editorial version of a source (immutable)", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^src_" } }, { "name": "n", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The source", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Source" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/relationship/{id}": { "get": { "operationId": "getRelationship", "summary": "The current relationship", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^rel_" } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The relationship", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Relationship" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/relationship/{id}/v/{n}": { "get": { "operationId": "getRelationshipVersion", "summary": "A specific editorial version of a relationship (immutable)", "description": "Canonical URL. Returns JSON for Accept: application/json (or a .json suffix), Markdown for Accept: text/markdown (or .md), and HTML for browsers. content_hash in cite_as can be recomputed from this JSON: remove the derived keys (url, links, trust, cite_as, graph, applicability, provenance) and hash the canonical JSON.", "tags": [ "Evidence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^rel_" } }, { "name": "n", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "as_of", "in": "query", "required": false, "description": "Date to apply the law as of (YYYY-MM-DD). Defaults to today.", "schema": { "type": "string", "format": "date" } }, { "name": "view", "in": "query", "required": false, "description": "compact returns the smaller packet form", "schema": { "type": "string", "enum": [ "full", "compact" ], "default": "full" } } ], "responses": { "200": { "description": "The relationship", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "ETag": { "description": "Content hash plus representation variant", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Relationship" } }, "text/markdown": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } } } }, "304": { "description": "Not modified (If-None-Match matched the ETag)" }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "No acceptable representation (NOT_ACCEPTABLE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/batch": { "post": { "operationId": "batchGet", "summary": "Fetch up to 100 evidence objects at once", "tags": [ "Evidence" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchRequest" } } } }, "responses": { "200": { "description": "Found items and IDs not found", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchResponse" } } } }, "400": { "description": "Invalid request (code INVALID_REQUEST)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "Body too large (PAYLOAD_TOO_LARGE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/relationships": { "get": { "operationId": "getRelationships", "summary": "Relationships between evidence objects", "tags": [ "Evidence" ], "parameters": [ { "name": "from", "in": "query", "required": false, "description": "Relationships from this ID", "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "description": "Relationships to this ID", "schema": { "type": "string" } }, { "name": "relation", "in": "query", "required": false, "description": "Relationship kind (alias: type)", "schema": { "type": "string", "enum": [ "establishes", "supports", "interprets", "applies", "limits", "distinguishes", "supersedes", "conflicts_with", "cites" ] } }, { "name": "as_of", "in": "query", "required": false, "description": "Only relationships that hold on this date", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "Matching relationships", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RelationshipsResponse" } } } }, "400": { "description": "Invalid request (code INVALID_REQUEST)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/evidence-packets": { "post": { "operationId": "buildEvidencePacket", "summary": "Build an evidence packet for a research question", "description": "Deterministic: the same request against the same dataset returns the same packet_id and body. The packet embeds compact copies of every object with its cite_as block, plus conflicts, limitations, and what was excluded and why.", "tags": [ "Research" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PacketRequest" } } } }, "responses": { "201": { "description": "The packet; Location is its canonical URL", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidencePacket" } } } }, "400": { "description": "Invalid request (code INVALID_REQUEST)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "402": { "description": "Packet requires paid agent access (PAYMENT_REQUIRED)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "413": { "description": "Body too large (PAYLOAD_TOO_LARGE)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/packet/{id}": { "get": { "operationId": "getPacket", "summary": "A previously built packet", "tags": [ "Research" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^pkt_[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "The packet", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidencePacket" } } } }, "402": { "description": "Packet requires paid agent access (PAYMENT_REQUIRED)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not found (NOT_FOUND or VERSION_NOT_FOUND)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/resolve": { "post": { "operationId": "resolveCitation", "summary": "Check a citation: current, revised, superseded, altered, or unknown", "tags": [ "Citations" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveRequest" } } } }, "responses": { "200": { "description": "Resolution result (not_found is a 200 with status not_found)", "headers": { "X-Request-Id": { "description": "Request ID; also recorded in the trace", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveResult" } } } }, "400": { "description": "Invalid request (code INVALID_REQUEST)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/topics": { "get": { "operationId": "listTopics", "summary": "Topics and the terms that match them", "tags": [ "Discovery" ], "responses": { "200": { "description": "Topic list" } } } }, "/.well-known/service.json": { "get": { "operationId": "serviceDescription", "summary": "Coverage, freshness, limits, and policies", "tags": [ "Discovery" ], "responses": { "200": { "description": "Service description" } } } }, "/llms.txt": { "get": { "operationId": "llmsTxt", "summary": "Agent-oriented index (llms.txt v2)", "tags": [ "Discovery" ], "responses": { "200": { "description": "Markdown", "content": { "text/markdown": {} } } } } }, "/mcp": { "post": { "operationId": "mcp", "summary": "MCP Streamable HTTP endpoint (see /docs/mcp)", "tags": [ "Discovery" ], "responses": { "200": { "description": "MCP response" } } } } }, "components": { "schemas": { "PacketRequest": { "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 1000, "description": "A research question about the law, not about a particular person's case" }, "jurisdiction": { "default": "us-ny-nyc", "description": "Jurisdiction to research. Parent jurisdictions (us-ny, us) are included automatically.", "type": "string" }, "as_of": { "description": "Date the law should be applied as of (YYYY-MM-DD). Defaults to today.", "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "topics": { "description": "Optional topic IDs to include in addition to those matched from the question (see /topics)", "maxItems": 20, "type": "array", "items": { "type": "string" } } }, "required": [ "question" ] }, "EvidencePacket": { "type": "object", "properties": { "packet_id": { "type": "string" }, "url": { "type": "string" }, "question": { "type": "string" }, "jurisdiction": { "type": "string" }, "as_of": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "flags": { "type": "array", "items": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] } }, "interpretation": { "type": "object", "properties": { "method": { "type": "string" }, "matched_topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "matched_terms": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "label", "matched_terms" ], "additionalProperties": false } }, "fact_specific": { "type": "boolean" }, "jurisdictions_searched": { "type": "array", "items": { "type": "string" } } }, "required": [ "method", "matched_topics", "fact_specific", "jurisdictions_searched" ], "additionalProperties": false }, "propositions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "authorities": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "cases": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "relationships": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "conflicts": { "type": "array", "items": { "type": "object", "properties": { "relationship": { "type": "string" }, "between": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" } }, "required": [ "relationship", "between", "note" ], "additionalProperties": false } }, "limitations": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "excluded": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "id", "reason" ], "additionalProperties": false } }, "provenance": { "type": "object", "properties": { "generator": { "type": "string" }, "dataset_version": { "type": "string" }, "dataset_hash": { "type": "string" }, "request": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "packet_hash": { "type": "string" } }, "required": [ "generator", "dataset_version", "dataset_hash", "request", "packet_hash" ], "additionalProperties": false } }, "required": [ "packet_id", "url", "question", "jurisdiction", "as_of", "status", "flags", "interpretation", "propositions", "authorities", "cases", "sources", "relationships", "conflicts", "limitations", "excluded", "provenance" ], "additionalProperties": false }, "EvidenceItem": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} }, "CiteAs": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "Trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false }, "Proposition": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^prop_[a-z0-9][a-z0-9_.-]*$" }, "version": { "default": 1, "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "jurisdiction": { "type": "string", "minLength": 1, "description": "Jurisdiction whose law this is, e.g. us-ny or us-ny-nyc" }, "domain": { "type": "string", "pattern": "^[a-z]+(\\.[a-z_]+)*$", "description": "Subject area, e.g. torts.sidewalk" }, "title": { "type": "string", "minLength": 1 }, "valid_from": { "default": null, "description": "First date the rule applies; null if long-standing", "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "valid_to": { "default": null, "description": "Last date the rule applies; null if still in effect", "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "temporal_notes": { "default": [], "description": "Date ranges where applicability is uncertain", "type": "array", "items": { "type": "object", "properties": { "from": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "to": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "note": { "type": "string", "minLength": 1 } }, "required": [ "from", "to", "note" ], "additionalProperties": false } }, "topics": { "default": [], "type": "array", "items": { "type": "string" } }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "verification": { "type": "object", "properties": { "verified_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ], "description": "Date every citation and quoted passage was last checked against its source" }, "methods": { "default": [], "description": "How each check was done, in plain words", "type": "array", "items": { "type": "string" } }, "human_review_status": { "default": "pending", "type": "string", "enum": [ "pending", "reviewed", "disputed" ] }, "reviewer": { "default": null, "type": [ "string", "null" ] }, "notes": { "type": "string" } }, "required": [ "verified_on", "methods", "human_review_status", "reviewer" ], "additionalProperties": false }, "revisions": { "default": [], "type": "array", "items": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "summary": { "type": "string", "minLength": 1 } }, "required": [ "version", "date", "summary" ], "additionalProperties": false } }, "statement": { "type": "string", "minLength": 1 }, "scope_notes": { "default": [], "type": "array", "items": { "type": "string" } }, "passages": { "default": [], "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^src_[a-z0-9][a-z0-9_.-]*$" }, "locator": { "type": "string", "minLength": 1, "description": "Where in the source, e.g. '§ 7-210(b)' or '10 NY3d at 521'" }, "text": { "type": "string", "minLength": 1, "description": "Verbatim text from the source" } }, "required": [ "source", "locator", "text" ], "additionalProperties": false } }, "type": { "type": "string", "const": "proposition" }, "source_ids": { "type": "array", "items": { "type": "string" } }, "relationship_ids": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string", "description": "Canonical URL (current version, or /v/{n} when pinned)" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "as_of": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "applies": { "type": "boolean" }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "reason": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] } }, "required": [ "as_of", "applies", "temporal_status", "reason", "status" ], "additionalProperties": false }, "graph": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {}, "description": "Relationships in and out, and for propositions the authorities and cases behind them" }, "provenance": { "type": "object", "properties": { "passages": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "locator": { "type": "string" }, "sha256": { "type": "string" }, "source_url": { "type": [ "string", "null" ] }, "retrieved": { "type": [ "string", "null" ] } }, "required": [ "source", "locator", "sha256", "source_url", "retrieved" ], "additionalProperties": false } } }, "required": [ "passages" ], "additionalProperties": false }, "links": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "version", "jurisdiction", "domain", "title", "valid_from", "valid_to", "temporal_notes", "topics", "status", "verification", "revisions", "statement", "scope_notes", "passages", "type", "source_ids", "relationship_ids", "url", "cite_as", "trust", "applicability", "graph", "provenance", "links" ], "additionalProperties": false }, "Authority": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^auth_[a-z0-9][a-z0-9_.-]*$" }, "version": { "default": 1, "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "jurisdiction": { "type": "string", "minLength": 1, "description": "Jurisdiction whose law this is, e.g. us-ny or us-ny-nyc" }, "domain": { "type": "string", "pattern": "^[a-z]+(\\.[a-z_]+)*$", "description": "Subject area, e.g. torts.sidewalk" }, "title": { "type": "string", "minLength": 1 }, "valid_from": { "default": null, "description": "First date the rule applies; null if long-standing", "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "valid_to": { "default": null, "description": "Last date the rule applies; null if still in effect", "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "temporal_notes": { "default": [], "description": "Date ranges where applicability is uncertain", "type": "array", "items": { "type": "object", "properties": { "from": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "to": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "note": { "type": "string", "minLength": 1 } }, "required": [ "from", "to", "note" ], "additionalProperties": false } }, "topics": { "default": [], "type": "array", "items": { "type": "string" } }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "verification": { "type": "object", "properties": { "verified_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ], "description": "Date every citation and quoted passage was last checked against its source" }, "methods": { "default": [], "description": "How each check was done, in plain words", "type": "array", "items": { "type": "string" } }, "human_review_status": { "default": "pending", "type": "string", "enum": [ "pending", "reviewed", "disputed" ] }, "reviewer": { "default": null, "type": [ "string", "null" ] }, "notes": { "type": "string" } }, "required": [ "verified_on", "methods", "human_review_status", "reviewer" ], "additionalProperties": false }, "revisions": { "default": [], "type": "array", "items": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "summary": { "type": "string", "minLength": 1 } }, "required": [ "version", "date", "summary" ], "additionalProperties": false } }, "citation": { "type": "string", "minLength": 1 }, "short_cite": { "type": "string", "minLength": 1 }, "authority_kind": { "type": "string", "enum": [ "federal_statute", "state_statute", "local_law", "regulation", "court_rule", "constitution" ] }, "authority_level": { "type": "string", "enum": [ "constitution", "primary_legislation", "local_legislation", "regulation", "court_of_last_resort", "intermediate_appellate", "trial_court", "secondary" ] }, "enacted_by": { "type": "string" }, "effective_date": { "default": null, "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "official_url": { "type": "string", "format": "uri" }, "passages": { "default": [], "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^src_[a-z0-9][a-z0-9_.-]*$" }, "locator": { "type": "string", "minLength": 1, "description": "Where in the source, e.g. '§ 7-210(b)' or '10 NY3d at 521'" }, "text": { "type": "string", "minLength": 1, "description": "Verbatim text from the source" } }, "required": [ "source", "locator", "text" ], "additionalProperties": false } }, "type": { "type": "string", "const": "authority" }, "source_ids": { "type": "array", "items": { "type": "string" } }, "relationship_ids": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string", "description": "Canonical URL (current version, or /v/{n} when pinned)" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "as_of": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "applies": { "type": "boolean" }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "reason": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] } }, "required": [ "as_of", "applies", "temporal_status", "reason", "status" ], "additionalProperties": false }, "graph": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {}, "description": "Relationships in and out, and for propositions the authorities and cases behind them" }, "provenance": { "type": "object", "properties": { "passages": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "locator": { "type": "string" }, "sha256": { "type": "string" }, "source_url": { "type": [ "string", "null" ] }, "retrieved": { "type": [ "string", "null" ] } }, "required": [ "source", "locator", "sha256", "source_url", "retrieved" ], "additionalProperties": false } } }, "required": [ "passages" ], "additionalProperties": false }, "links": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "version", "jurisdiction", "domain", "title", "valid_from", "valid_to", "temporal_notes", "topics", "status", "verification", "revisions", "citation", "short_cite", "authority_kind", "authority_level", "effective_date", "official_url", "passages", "type", "source_ids", "relationship_ids", "url", "cite_as", "trust", "applicability", "graph", "provenance", "links" ], "additionalProperties": false }, "Case": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^case_[a-z0-9][a-z0-9_.-]*$" }, "version": { "default": 1, "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "jurisdiction": { "type": "string", "minLength": 1, "description": "Jurisdiction whose law this is, e.g. us-ny or us-ny-nyc" }, "domain": { "type": "string", "pattern": "^[a-z]+(\\.[a-z_]+)*$", "description": "Subject area, e.g. torts.sidewalk" }, "title": { "type": "string", "minLength": 1 }, "valid_from": { "default": null, "description": "First date the rule applies; null if long-standing", "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "valid_to": { "default": null, "description": "Last date the rule applies; null if still in effect", "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "temporal_notes": { "default": [], "description": "Date ranges where applicability is uncertain", "type": "array", "items": { "type": "object", "properties": { "from": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "to": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "note": { "type": "string", "minLength": 1 } }, "required": [ "from", "to", "note" ], "additionalProperties": false } }, "topics": { "default": [], "type": "array", "items": { "type": "string" } }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "verification": { "type": "object", "properties": { "verified_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ], "description": "Date every citation and quoted passage was last checked against its source" }, "methods": { "default": [], "description": "How each check was done, in plain words", "type": "array", "items": { "type": "string" } }, "human_review_status": { "default": "pending", "type": "string", "enum": [ "pending", "reviewed", "disputed" ] }, "reviewer": { "default": null, "type": [ "string", "null" ] }, "notes": { "type": "string" } }, "required": [ "verified_on", "methods", "human_review_status", "reviewer" ], "additionalProperties": false }, "revisions": { "default": [], "type": "array", "items": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "summary": { "type": "string", "minLength": 1 } }, "required": [ "version", "date", "summary" ], "additionalProperties": false } }, "name": { "type": "string", "minLength": 1 }, "citation": { "type": "string", "minLength": 1 }, "parallel_citations": { "default": [], "type": "array", "items": { "type": "string" } }, "court": { "type": "string", "minLength": 1 }, "court_level": { "type": "string", "enum": [ "constitution", "primary_legislation", "local_legislation", "regulation", "court_of_last_resort", "intermediate_appellate", "trial_court", "secondary" ] }, "decided": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "official_url": { "type": "string", "format": "uri" }, "courtlistener": { "default": null, "anyOf": [ { "type": "object", "properties": { "cluster_id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "format": "uri" } }, "required": [ "cluster_id", "url" ], "additionalProperties": false }, { "type": "null" } ] }, "editor_summary": { "type": "string", "minLength": 1, "description": "Editor's one-sentence summary; not a quotation" }, "passages": { "default": [], "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^src_[a-z0-9][a-z0-9_.-]*$" }, "locator": { "type": "string", "minLength": 1, "description": "Where in the source, e.g. '§ 7-210(b)' or '10 NY3d at 521'" }, "text": { "type": "string", "minLength": 1, "description": "Verbatim text from the source" } }, "required": [ "source", "locator", "text" ], "additionalProperties": false } }, "type": { "type": "string", "const": "case" }, "source_ids": { "type": "array", "items": { "type": "string" } }, "relationship_ids": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string", "description": "Canonical URL (current version, or /v/{n} when pinned)" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "as_of": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "applies": { "type": "boolean" }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "reason": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] } }, "required": [ "as_of", "applies", "temporal_status", "reason", "status" ], "additionalProperties": false }, "graph": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {}, "description": "Relationships in and out, and for propositions the authorities and cases behind them" }, "provenance": { "type": "object", "properties": { "passages": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "locator": { "type": "string" }, "sha256": { "type": "string" }, "source_url": { "type": [ "string", "null" ] }, "retrieved": { "type": [ "string", "null" ] } }, "required": [ "source", "locator", "sha256", "source_url", "retrieved" ], "additionalProperties": false } } }, "required": [ "passages" ], "additionalProperties": false }, "links": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "version", "jurisdiction", "domain", "title", "valid_from", "valid_to", "temporal_notes", "topics", "status", "verification", "revisions", "name", "citation", "parallel_citations", "court", "court_level", "decided", "courtlistener", "editor_summary", "passages", "type", "source_ids", "relationship_ids", "url", "cite_as", "trust", "applicability", "graph", "provenance", "links" ], "additionalProperties": false }, "Source": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^src_[a-z0-9][a-z0-9_.-]*$" }, "title": { "type": "string", "minLength": 1 }, "version": { "default": 1, "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "jurisdiction": { "type": "string" }, "domain": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "verification": { "type": "object", "properties": { "verified_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ], "description": "Date every citation and quoted passage was last checked against its source" }, "methods": { "default": [], "description": "How each check was done, in plain words", "type": "array", "items": { "type": "string" } }, "human_review_status": { "default": "pending", "type": "string", "enum": [ "pending", "reviewed", "disputed" ] }, "reviewer": { "default": null, "type": [ "string", "null" ] }, "notes": { "type": "string" } }, "required": [ "verified_on", "methods", "human_review_status", "reviewer" ], "additionalProperties": false }, "revisions": { "default": [], "type": "array", "items": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "summary": { "type": "string", "minLength": 1 } }, "required": [ "version", "date", "summary" ], "additionalProperties": false } }, "publisher": { "type": "string", "minLength": 1 }, "source_url": { "type": "string", "format": "uri", "description": "Where the source text was read" }, "source_type": { "type": "string", "enum": [ "official_code", "official_legislature", "official_reporter", "court_website", "courtlistener", "government_agency", "secondary" ] }, "retrieved": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "citation": { "type": "string" }, "courtlistener": { "type": "object", "properties": { "cluster_id": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "format": "uri" } }, "required": [ "cluster_id", "url" ], "additionalProperties": false }, "notes": { "type": "string" }, "type": { "type": "string", "const": "source" }, "owner": { "type": "string", "description": "The authority, case, or proposition this source belongs to" }, "url": { "type": "string", "description": "Canonical URL (current version, or /v/{n} when pinned)" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "as_of": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "applies": { "type": "boolean" }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "reason": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] } }, "required": [ "as_of", "applies", "temporal_status", "reason", "status" ], "additionalProperties": false }, "graph": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {}, "description": "Relationships in and out, and for propositions the authorities and cases behind them" }, "provenance": { "type": "object", "properties": { "passages": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "locator": { "type": "string" }, "sha256": { "type": "string" }, "source_url": { "type": [ "string", "null" ] }, "retrieved": { "type": [ "string", "null" ] } }, "required": [ "source", "locator", "sha256", "source_url", "retrieved" ], "additionalProperties": false } } }, "required": [ "passages" ], "additionalProperties": false }, "links": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "title", "version", "jurisdiction", "domain", "status", "verification", "revisions", "publisher", "source_url", "source_type", "retrieved", "type", "owner", "url", "cite_as", "trust", "applicability", "graph", "provenance", "links" ], "additionalProperties": false }, "Relationship": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^rel_[a-z0-9][a-z0-9_.-]*$" }, "relation": { "type": "string", "enum": [ "establishes", "supports", "interprets", "applies", "limits", "distinguishes", "supersedes", "conflicts_with", "cites" ] }, "to": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "note": { "type": "string", "minLength": 1, "description": "Plain description of the relationship" }, "valid_from": { "default": null, "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "valid_to": { "default": null, "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "passages": { "default": [], "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^src_[a-z0-9][a-z0-9_.-]*$" }, "locator": { "type": "string", "minLength": 1, "description": "Where in the source, e.g. '§ 7-210(b)' or '10 NY3d at 521'" }, "text": { "type": "string", "minLength": 1, "description": "Verbatim text from the source" } }, "required": [ "source", "locator", "text" ], "additionalProperties": false } }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "revisions": { "type": "array", "items": { "type": "object", "properties": { "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "summary": { "type": "string" } }, "required": [ "version", "date", "summary" ], "additionalProperties": false } }, "type": { "type": "string", "const": "relationship" }, "from": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "title": { "type": "string" }, "jurisdiction": { "type": "string" }, "domain": { "type": "string" }, "verification": { "type": "object", "properties": { "verified_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ], "description": "Date every citation and quoted passage was last checked against its source" }, "methods": { "default": [], "description": "How each check was done, in plain words", "type": "array", "items": { "type": "string" } }, "human_review_status": { "default": "pending", "type": "string", "enum": [ "pending", "reviewed", "disputed" ] }, "reviewer": { "default": null, "type": [ "string", "null" ] }, "notes": { "type": "string" } }, "required": [ "verified_on", "methods", "human_review_status", "reviewer" ], "additionalProperties": false }, "url": { "type": "string", "description": "Canonical URL (current version, or /v/{n} when pinned)" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false }, "applicability": { "type": "object", "properties": { "as_of": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "applies": { "type": "boolean" }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "reason": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] } }, "required": [ "as_of", "applies", "temporal_status", "reason", "status" ], "additionalProperties": false }, "graph": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {}, "description": "Relationships in and out, and for propositions the authorities and cases behind them" }, "provenance": { "type": "object", "properties": { "passages": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "locator": { "type": "string" }, "sha256": { "type": "string" }, "source_url": { "type": [ "string", "null" ] }, "retrieved": { "type": [ "string", "null" ] } }, "required": [ "source", "locator", "sha256", "source_url", "retrieved" ], "additionalProperties": false } } }, "required": [ "passages" ], "additionalProperties": false }, "links": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "relation", "to", "note", "valid_from", "valid_to", "passages", "status", "version", "revisions", "type", "from", "title", "jurisdiction", "domain", "verification", "url", "cite_as", "trust", "applicability", "graph", "provenance", "links" ], "additionalProperties": false }, "BatchRequest": { "type": "object", "properties": { "ids": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" } }, "as_of": { "description": "Date the law should be applied as of (YYYY-MM-DD). Defaults to today.", "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "view": { "default": "compact", "type": "string", "enum": [ "compact", "full" ] } }, "required": [ "ids" ] }, "BatchResponse": { "type": "object", "properties": { "as_of": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "dataset_version": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "not_found": { "type": "array", "items": { "type": "string" } } }, "required": [ "as_of", "dataset_version", "items", "not_found" ], "additionalProperties": false }, "SearchResponse": { "type": "object", "properties": { "query": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "interpretation": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "total": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "next_cursor": { "type": [ "string", "null" ] }, "dataset_version": { "type": "string" } }, "required": [ "query", "interpretation", "total", "results", "next_cursor", "dataset_version" ], "additionalProperties": false }, "RelationshipsResponse": { "type": "object", "properties": { "query": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "title": { "type": "string" }, "status": { "type": "string", "enum": [ "VERIFIED", "UNVERIFIED_CANDIDATE", "INSUFFICIENT_EVIDENCE", "CONFLICTING_AUTHORITY", "TEMPORAL_UNCERTAINTY" ] }, "url": { "type": "string" }, "cite_as": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, "trust": { "type": "object", "properties": { "authority_level": { "type": [ "string", "null" ] }, "source_type": { "type": [ "string", "null" ] }, "primary_source": { "type": "boolean" }, "verified": { "type": "boolean" }, "verification_date": { "type": [ "string", "null" ] }, "source_freshness": { "type": [ "string", "null" ] }, "temporal_status": { "type": "string", "enum": [ "current", "historical", "future", "uncertain", "timeless" ] }, "conflict_status": { "type": "string", "enum": [ "none_known", "limited", "conflicting" ] }, "human_review_status": { "type": "string" }, "provenance_complete": { "type": "boolean" } }, "required": [ "authority_level", "source_type", "primary_source", "verified", "verification_date", "source_freshness", "temporal_status", "conflict_status", "human_review_status", "provenance_complete" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "status", "url", "cite_as", "trust" ], "additionalProperties": {} } }, "dataset_version": { "type": "string" } }, "required": [ "query", "items", "dataset_version" ], "additionalProperties": false }, "ResolveRequest": { "type": "object", "properties": { "citation": { "type": "string", "minLength": 3, "description": "An evidence ID (prop_..., optionally with @v2), a canonical URL (optionally ending in /v/{n}), or a legal citation such as '10 NY3d 517'" }, "content_hash": { "description": "The content_hash from the cite_as block you received, to check the object has not changed", "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }, "required": [ "citation" ] }, "ResolveResult": { "type": "object", "properties": { "input": { "type": "string" }, "matched_by": { "anyOf": [ { "type": "string", "enum": [ "id", "url", "legal_citation" ] }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "current", "revised", "superseded", "hash_mismatch", "not_found", "version_not_found" ] }, "id": { "type": [ "string", "null" ] }, "type": { "anyOf": [ { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, { "type": "null" } ] }, "requested_version": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "current_version": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "matched_version": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "content_hash_matches": { "type": [ "boolean", "null" ] }, "current": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, { "type": "null" } ] }, "requested": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(prop|auth|case|src|rel)_[a-z0-9][a-z0-9_.-]*$" }, "type": { "type": "string", "enum": [ "proposition", "authority", "case", "source", "relationship" ] }, "version": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "url": { "type": "string" }, "content_hash": { "type": "string" }, "dataset_version": { "type": "string" }, "citation": { "description": "Legal citation, for authorities and cases", "type": "string" } }, "required": [ "id", "type", "version", "url", "content_hash", "dataset_version" ], "additionalProperties": false }, { "type": "null" } ] }, "superseded_by": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "relationship": { "type": "string" }, "valid_from": { "type": [ "string", "null" ] } }, "required": [ "id", "relationship", "valid_from" ], "additionalProperties": false } }, "message": { "type": "string" } }, "required": [ "input", "matched_by", "status", "id", "type", "requested_version", "current_version", "matched_version", "content_hash_matches", "current", "requested", "superseded_by", "message" ], "additionalProperties": false }, "Problem": { "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "code": { "type": "string", "enum": [ "INVALID_REQUEST", "NOT_FOUND", "VERSION_NOT_FOUND", "NOT_ACCEPTABLE", "PAYLOAD_TOO_LARGE", "PAYMENT_REQUIRED", "INTERNAL_ERROR" ] }, "detail": { "type": "string" }, "request_id": { "type": "string" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } } }, "required": [ "type", "title", "status", "code", "detail", "request_id" ], "additionalProperties": false } } } }