Verify one legal citation

Verify one legal citation. Body: {"citation": "<string>"} - full ("Miranda v. Arizona, 384 U.S. 436 (1966)") or bare ("384 U.S. 436"); the case name enables mismatch detection. Deterministic: regex plus cache / 14.2M-case corpus / CourtListener, no LLM in the path. status=verified (name confirmed), suspicious (reporter resolves to a DIFFERENT case - the fabrication signature), or not_found. verified=false is a finding, not an error: do not retry. Only verified results are cached.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://veridictum.legal/api/v1/agent/verify

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "citation": "Miranda v. Arizona, 384 U.S. 436 (1966)"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "citation": {
              "description": "One legal citation. Full (\"Miranda v. Arizona, 384 U.S. 436 (1966)\") or bare (\"384 U.S. 436\"). Supplying the case name is what enables mismatch detection; a bare citation can only be confirmed to exist and returns name_match='not_checked'.",
              "minLength": 1,
              "type": "string"
            }
          },
          "required": [
            "citation"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "api_call_made": {
              "type": "boolean"
            },
            "cached": {
              "description": "Only verified results are ever cached; suspicious and not_found answers are re-checked on every call.",
              "type": "boolean"
            },
            "case_name": {
              "type": [
                "string",
                "null"
              ]
            },
            "citation": {
              "description": "The citation exactly as submitted, echoed back.",
              "type": "string"
            },
            "confidence": {
              "type": "string"
            },
            "court": {
              "type": [
                "string",
                "null"
              ]
            },
            "courtlistener_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "courtlistener_url": {
              "description": "Full opinion on CourtListener. Never truncate it.",
              "type": [
                "string",
                "null"
              ]
            },
            "date_filed": {
              "description": "ISO 8601 date.",
              "type": [
                "string",
                "null"
              ]
            },
            "message": {
              "type": [
                "string",
                "null"
              ]
            },
            "name_match": {
              "description": "confirmed: the submitted name matches the case found. mismatch: a DIFFERENT case. not_checked: a bare citation carried no name to check.",
              "enum": [
                "confirmed",
                "mismatch",
                "not_checked",
                null
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "source": {
              "description": "Which lookup tier answered.",
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "description": "verified: resolves to a real case and any submitted name matched. suspicious: the volume/reporter/page resolves but to a DIFFERENT case than the name given - the signature of a fabricated citation. not_found: no case matches.",
              "enum": [
                "verified",
                "suspicious",
                "not_found"
              ],
              "type": "string"
            },
            "tier": {
              "description": "Importance: 1=landmark, 2=highly cited, 3=standard.",
              "type": [
                "integer",
                "null"
              ]
            },
            "verified": {
              "description": "True only for status=verified. False is a finding, not an error.",
              "type": "boolean"
            }
          },
          "required": [
            "citation",
            "status",
            "verified"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON