Citation Lookup and Verification API

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"/> <meta http-equiv="Content-Language" content="en"/> <meta name="language" content="en_us"/> <meta name="viewport" content="width=device-width,initial-scale=1"/> <meta name="description" content="Trained on over 50 million citations going back centuries, our citation lookup API can translate a citation you have to a link on our site, or it can serve as a guardrail to help identify and prevent hallucinated citations."/> <link rel="search" type="application/opensearchdescription+xml" title="CourtListener" href="https://storage.courtlistener.com/static/xml/opensearch.72b938ad7809.xml" /> <meta name="application-name" content="CourtListener"/> <meta name="msapplication-tooltip" content="Create alerts, search for and browse the latest case law."/> <meta name="msapplication-starturl" content="https://www.courtlistener.com"/> <meta name="msapplication-navbutton-color" content="#6683B7"/> <meta name="twitter:card" content="summary"> <meta name="twitter:creator" content="@freelawproject"> <meta name="twitter:site" content="@courtlistener"> <meta property="og:type" content="website"/> <meta property="og:title" content="Citation Lookup and Verification API – CourtListener.com"/> <meta property="og:description" content="Trained on over 50 million citations going back centuries, our citation lookup API can translate a citation you have to a link on our site, or it can serve as a guardrail to help identify and prevent hallucinated citations."> <meta property="og:url" content="https://www.courtlistener.com/help/api/rest/citation-lookup/"/> <meta property="og:site_name" content="CourtListener"/> <meta property="og:image" content="https://storage.courtlistener.com/static/png/og-image-1200x630.7f25387a570b.png"/> <meta property="og:image:type" content="image/png"/> <meta property="twitter:image:alt" content="The CourtListener logo"/> <meta property="og:image:width" content="1200"/> <meta property="og:image:height" content="630"/> <link rel="icon" href="https://storage.courtlistener.com/static/ico/favicon.db8385d9ed4d.ico" sizes="32x32"> <link rel="icon" href="https://storage.courtlistener.com/static/svg/favicon.a124c6fa7c63.svg" type="image/svg+xml"> <link rel="apple-touch-icon" href="https://storage.courtlistener.com/static/png/apple-touch-icon.bd1491b64e6d.png"> <link rel="manifest" href="https://storage.courtlistener.com/static/json/manifest.ea07720093b9.json"> <link href="https://storage.courtlistener.com/static/css/font-awesome.71fa7db63e3e.css" rel="stylesheet"> <title>Citation Lookup and Verification API – CourtListener.com</title> <link rel="stylesheet" href="https://storage.courtlistener.com/static/css/bootstrap/3.3.0/bootstrap.min.90ccf319d703.css" type="text/css"> <link rel="stylesheet" href="https://storage.courtlistener.com/static/css/override.d4e19cd0bd0b.css" type="text/css" media="screen, projection"> </head> <body class=""> <div class="container round-bottom"> <header class="row">    <div class="navbar navbar-default" role="navigation"> <div class="container-fluid"> <div class="navbar-header"> <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="/" tabindex="1"> <svg class="cl-full-logo" viewBox="0 0 635.32 292.37" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg"> <g id="Layer_2" data-name="Layer 2"> <g> <rect class="cls-4" x="144.69" y="260.05" width="7.44" height="26.76"/> <rect class="cls-4" x="69.06" y="260.05" width="7.44" height="26.76"/> <rect class="cls-4" x="87.97" y="260.05" width="7.44" height="26.76"/> <rect class="cls-1" x="106.88" y="260.05" width="7.44" height="26.76"/> <rect class="cls-4" x="125.78" y="260.05" width="7.44" height="26.76"/> </g> <g> <g> <path class="cls-1" d="M63.34,216.92c0-3.14.57-6.24,1.7-9.31,1.13-3.07,2.79-5.81,4.96-8.23,2.17-2.42,4.83-4.37,7.97-5.87,3.14-1.5,6.72-2.25,10.73-2.25,4.73,0,8.83,1.04,12.28,3.12,3.45,2.08,6.03,4.78,7.72,8.12l-7.68,5.29c-.68-1.45-1.5-2.67-2.46-3.66-.97-.99-2.01-1.78-3.12-2.36-1.11-.58-2.27-1-3.48-1.27-1.21-.27-2.39-.4-3.55-.4-2.51,0-4.7.51-6.56,1.52-1.86,1.02-3.41,2.33-4.64,3.95-1.23,1.62-2.16,3.46-2.79,5.51-.63,2.05-.94,4.1-.94,6.12,0,2.27.36,4.46,1.09,6.56.72,2.1,1.75,3.95,3.08,5.54,1.33,1.59,2.92,2.88,4.78,3.84,1.86.97,3.9,1.45,6.12,1.45,1.16,0,2.37-.15,3.62-.43,1.26-.29,2.45-.75,3.59-1.38,1.13-.63,2.19-1.44,3.15-2.43.97-.99,1.74-2.19,2.32-3.59l8.19,4.71c-.82,1.93-1.99,3.64-3.52,5.11-1.52,1.47-3.24,2.72-5.15,3.73-1.91,1.01-3.95,1.79-6.12,2.32-2.17.53-4.3.8-6.38.8-3.67,0-7.03-.77-10.07-2.32-3.04-1.55-5.67-3.56-7.86-6.05-2.2-2.49-3.91-5.31-5.15-8.48-1.23-3.16-1.85-6.39-1.85-9.68Z"/> <path class="cls-1" d="M138.14,243.38c-3.77,0-7.19-.74-10.26-2.21-3.07-1.47-5.7-3.43-7.9-5.87-2.2-2.44-3.9-5.23-5.11-8.37-1.21-3.14-1.81-6.35-1.81-9.64s.64-6.72,1.92-9.86c1.28-3.14,3.04-5.92,5.29-8.33,2.25-2.42,4.92-4.34,8.01-5.76,3.09-1.42,6.45-2.14,10.07-2.14s7.11.76,10.18,2.28c3.07,1.52,5.69,3.52,7.86,5.98,2.17,2.46,3.87,5.27,5.07,8.41,1.21,3.14,1.81,6.33,1.81,9.57,0,3.43-.63,6.7-1.88,9.82-1.26,3.12-3,5.87-5.22,8.26-2.22,2.39-4.88,4.3-7.97,5.73-3.09,1.43-6.45,2.14-10.07,2.14ZM123.21,217.29c0,2.22.34,4.37,1.01,6.45.68,2.08,1.65,3.91,2.94,5.51,1.28,1.59,2.85,2.88,4.71,3.84,1.86.97,3.97,1.45,6.34,1.45s4.55-.49,6.41-1.49c1.86-.99,3.43-2.31,4.71-3.95,1.28-1.64,2.25-3.49,2.9-5.54.65-2.05.98-4.14.98-6.27s-.35-4.37-1.05-6.45c-.7-2.08-1.69-3.91-2.97-5.51-1.28-1.59-2.85-2.86-4.71-3.8-1.86-.94-3.95-1.41-6.27-1.41s-4.57.5-6.45,1.49c-1.88.99-3.46,2.3-4.71,3.91-1.26,1.62-2.21,3.46-2.86,5.51-.65,2.05-.98,4.14-.98,6.27Z"/> <path class="cls-1" d="M192.71,234.54c2.37,0,4.36-.48,5.98-1.45,1.62-.97,2.92-2.22,3.91-3.77.99-1.55,1.69-3.32,2.1-5.33.41-2,.62-4.07.62-6.2v-26.24h9.93v26.24c0,3.53-.42,6.84-1.27,9.93-.85,3.09-2.17,5.8-3.99,8.12s-4.14,4.16-6.99,5.51c-2.85,1.35-6.26,2.03-10.22,2.03s-7.6-.71-10.47-2.14c-2.88-1.42-5.21-3.31-6.99-5.65-1.79-2.34-3.08-5.06-3.88-8.15-.8-3.09-1.2-6.31-1.2-9.64v-26.24h10v26.24c0,2.17.21,4.26.62,6.27.41,2.01,1.11,3.78,2.1,5.33.99,1.55,2.28,2.79,3.88,3.73s3.55,1.41,5.87,1.41Z"/> <path class="cls-1" d="M225.33,243.01v-51.46h22.76c2.37,0,4.55.5,6.56,1.49,2,.99,3.73,2.3,5.18,3.91,1.45,1.62,2.58,3.46,3.41,5.51.82,2.05,1.23,4.12,1.23,6.2,0,3.33-.83,6.37-2.5,9.1-1.67,2.73-3.93,4.7-6.78,5.91l11.74,19.35h-11.23l-10.51-17.25h-9.86v17.25h-10ZM235.33,217h12.54c.92,0,1.78-.22,2.57-.65.8-.43,1.49-1.03,2.07-1.78.58-.75,1.04-1.63,1.38-2.65.34-1.01.51-2.1.51-3.26s-.19-2.32-.58-3.33c-.39-1.01-.91-1.9-1.56-2.65-.65-.75-1.4-1.33-2.25-1.74-.85-.41-1.7-.62-2.57-.62h-12.1v16.67Z"/> </g> <path class="cls-1" d="M310.71,200.33h-16.45v42.69h-9.93v-42.69h-16.45v-8.77h42.83v8.77Z"/> <g> <path class="cls-1" d="M329.91,243.01v-51.46h5.07v46.96h29.72v4.49h-34.79Z"/> <path class="cls-1" d="M368.54,243.01v-51.46h5.07v51.46h-5.07Z"/> <path class="cls-1" d="M412.97,201.2c-1.45-1.64-3.38-2.97-5.8-3.99-2.42-1.01-5.17-1.52-8.26-1.52-4.54,0-7.85.86-9.93,2.57-2.08,1.72-3.12,4.05-3.12,6.99,0,1.55.28,2.82.83,3.81.55.99,1.41,1.85,2.57,2.57,1.16.73,2.65,1.35,4.46,1.88,1.81.53,3.95,1.06,6.41,1.59,2.75.58,5.23,1.23,7.43,1.96,2.2.72,4.07,1.63,5.62,2.72,1.55,1.09,2.73,2.4,3.55,3.95.82,1.55,1.23,3.48,1.23,5.8s-.46,4.42-1.38,6.16c-.92,1.74-2.2,3.19-3.84,4.35-1.64,1.16-3.6,2.02-5.87,2.57-2.27.55-4.76.83-7.46.83-7.97,0-14.86-2.49-20.66-7.46l2.54-4.13c.92.97,2.02,1.88,3.3,2.75,1.28.87,2.71,1.63,4.28,2.28,1.57.65,3.25,1.16,5.04,1.52,1.79.36,3.67.54,5.65.54,4.11,0,7.31-.74,9.6-2.21,2.29-1.47,3.44-3.71,3.44-6.7,0-1.59-.33-2.94-.98-4.02-.65-1.09-1.63-2.03-2.94-2.83-1.3-.8-2.92-1.49-4.86-2.07-1.93-.58-4.18-1.16-6.74-1.74-2.71-.63-5.07-1.28-7.1-1.96-2.03-.68-3.74-1.52-5.15-2.54-1.4-1.01-2.45-2.23-3.15-3.66-.7-1.42-1.05-3.18-1.05-5.25,0-2.37.45-4.48,1.34-6.34.89-1.86,2.16-3.41,3.81-4.64,1.64-1.23,3.58-2.17,5.8-2.83,2.22-.65,4.69-.98,7.39-.98,3.43,0,6.49.52,9.17,1.56,2.68,1.04,5.11,2.5,7.28,4.38l-2.46,4.06Z"/> <path class="cls-1" d="M459.79,196.05h-18.34v46.97h-5.07v-46.97h-18.34v-4.49h41.75v4.49Z"/> <path class="cls-1" d="M498.42,238.52v4.49h-34.57v-51.46h33.92v4.49h-28.85v18.55h25.15v4.28h-25.15v19.64h29.5Z"/> <path class="cls-1" d="M509.43,200.98v42.04h-5.07v-51.46h3.91l34.06,42.83v-42.76h5.07v51.39h-4.42l-33.56-42.04Z"/> <path class="cls-1" d="M591.26,238.52v4.49h-34.57v-51.46h33.92v4.49h-28.85v18.55h25.15v4.28h-25.15v19.64h29.5Z"/> <path class="cls-1" d="M597.2,243.01v-51.46h21.74c2.22,0,4.26.47,6.12,1.41,1.86.94,3.47,2.17,4.82,3.7,1.35,1.52,2.4,3.25,3.15,5.18.75,1.93,1.12,3.89,1.12,5.87s-.28,3.68-.83,5.4c-.56,1.72-1.33,3.26-2.32,4.64-.99,1.38-2.19,2.54-3.59,3.48-1.4.94-2.97,1.58-4.71,1.92l12.61,19.86h-5.73l-12.1-18.99h-15.22v18.99h-5.07ZM602.27,219.53h16.81c1.5,0,2.86-.33,4.1-.98,1.23-.65,2.28-1.53,3.15-2.65.87-1.11,1.55-2.37,2.03-3.77.48-1.4.73-2.87.73-4.42s-.28-3.03-.83-4.46c-.56-1.42-1.3-2.67-2.25-3.73-.94-1.06-2.05-1.91-3.33-2.54-1.28-.63-2.62-.94-4.02-.94h-16.38v23.48Z"/> </g> </g> <g> <path class="cls-2" d="M193.32,279.1c0,1.01-.2,1.94-.61,2.79-.41.85-.95,1.58-1.63,2.2-.68.62-1.48,1.1-2.39,1.44s-1.89.51-2.93.51h-12.73v-26.99h13c.94,0,1.79.2,2.55.61.76.41,1.41.93,1.94,1.58.53.65.94,1.38,1.24,2.2.29.82.44,1.65.44,2.49,0,1.37-.34,2.62-1.03,3.74-.68,1.13-1.63,1.97-2.85,2.53,1.55.46,2.77,1.31,3.67,2.55.9,1.24,1.35,2.69,1.35,4.33ZM175.69,261.38v9.96h9.27c.66,0,1.27-.14,1.84-.42.57-.28,1.06-.65,1.46-1.1.41-.46.72-.98.95-1.58.23-.6.34-1.22.34-1.88s-.11-1.33-.32-1.94c-.22-.61-.52-1.13-.91-1.58-.39-.44-.86-.8-1.39-1.06-.53-.27-1.12-.4-1.75-.4h-9.5ZM190.66,278.64c0-.66-.11-1.3-.34-1.92-.23-.62-.55-1.16-.97-1.63-.42-.47-.91-.85-1.48-1.14-.57-.29-1.18-.44-1.84-.44h-10.34v10.22h10.07c.68,0,1.32-.14,1.92-.42.59-.28,1.11-.65,1.56-1.12.44-.47.79-1.01,1.05-1.63.25-.62.38-1.26.38-1.92Z"/> <path class="cls-2" d="M200.05,259.07l8.82,14.52,8.89-14.52h2.89l-10.45,16.95v10.03h-2.66v-10.11l-10.41-16.88h2.93Z"/> </g> <g> <path class="cls-2" d="M238.36,286.05v-26.99h17.71v2.36h-15.05v9.92h12.69v2.2h-12.69v12.5h-2.66Z"/> <path class="cls-2" d="M263.41,286.05v-26.99h11.4c1.17,0,2.24.25,3.21.74.97.49,1.82,1.14,2.53,1.94.71.8,1.26,1.7,1.65,2.72.39,1.01.59,2.04.59,3.08s-.15,1.93-.44,2.83c-.29.9-.7,1.71-1.22,2.43-.52.72-1.15,1.33-1.88,1.82-.74.49-1.56.83-2.47,1.01l6.61,10.41h-3l-6.35-9.96h-7.98v9.96h-2.66ZM266.07,273.74h8.82c.79,0,1.5-.17,2.15-.51s1.2-.8,1.65-1.39c.46-.58.81-1.24,1.06-1.98.25-.73.38-1.51.38-2.32s-.15-1.59-.44-2.34c-.29-.75-.68-1.4-1.18-1.96-.49-.56-1.08-1-1.75-1.33-.67-.33-1.37-.49-2.11-.49h-8.59v12.31Z"/> <path class="cls-2" d="M309.02,283.7v2.36h-18.13v-26.99h17.79v2.36h-15.13v9.73h13.19v2.24h-13.19v10.3h15.47Z"/> <path class="cls-2" d="M334.82,283.7v2.36h-18.13v-26.99h17.79v2.36h-15.13v9.73h13.19v2.24h-13.19v10.3h15.47Z"/> </g> <path class="cls-2" d="M344.4,286.47c-.68,0-1.26-.22-1.75-.66-.49-.44-.74-1.05-.74-1.84,0-.67.24-1.24.7-1.72.47-.48,1.05-.72,1.74-.72s1.28.24,1.76.71c.49.48.73,1.05.73,1.73,0,.78-.24,1.39-.73,1.83-.49.44-1.06.66-1.71.66Z"/> <g> <path class="cls-2" d="M353.01,286.05v-26.99h2.66v24.63h15.58v2.36h-18.24Z"/> <path class="cls-2" d="M386.19,259.07h2.24l11.21,26.99h-2.81l-3.5-8.44h-12.13l-3.46,8.44h-2.85l11.29-26.99ZM392.73,275.52l-5.44-13.34-5.51,13.34h10.95Z"/> </g> <path class="cls-2" d="M409.07,259.26h2.51l3.8,9.58,3.84-9.58h2.55l-4.71,11.52,5.17,12.2,9.77-23.91h2.89l-11.44,26.99h-2.36l-5.66-13.34-5.7,13.34h-2.32l-11.4-26.99h2.85l9.81,23.91,5.13-12.2-4.71-11.52Z"/> <path class="cls-1" d="M108.64.25c-3.36.78-6.07,3.5-6.83,6.86-1.03,4.57,1.38,8.74,5.17,10.47v157.28h7.7V17.59c3.2-1.44,5.43-4.64,5.43-8.37,0-5.79-5.4-10.36-11.47-8.97Z"/> </g> <a xlink:href="https://free.law/" xlink:show="new"> <g id="Layer_4" data-name="Layer 4"> <rect class="free-law-link" x="64.43" y="247.23" width="399.41" height="45.14"/> </g> </a> <g id="Layer_3" data-name="Layer 3"> <g> <path class="cls-4" d="M208.79,138.68h-47.85v3.95c.02,4.78,2.93,7.71,7.69,7.71,10.42-.02,20.83-.05,31.27-.07.95-.02,1.94-.05,2.86-.3,5.75-1.52,6.81-6.28,6.03-11.29Z"/> <path class="cls-4" d="M219.07,80c-1.73-1.76-3.88-2.63-6.44-2.63-2.77,0-5.03.85-6.79,2.59-.85.83-1.5,1.8-1.92,2.89h-57.83v92.79h7.51s0-85.29,0-85.29h29.05c0,3.35,0,6.7-.05,10.05-.02.65-.12,1.34-.32,1.94-3.44,9.72-6.91,19.42-10.3,29.12-.3.85-.67,1.13-1.52,1.11-3-.05-5.98,0-8.96.02-.99,0-1.39.39-1.39,1.27s.44,1.29,1.5,1.27c2.86,0,5.7-.07,8.57-.09,12.93-.05,25.87-.12,38.82-.16,1.18,0,1.73-.44,1.71-1.29s-.51-1.22-1.66-1.22c-2.47,0-4.92,0-7.37.05-.72.02-1.04-.21-1.32-.88-4.11-9.7-8.22-19.38-12.33-29.08-.14-.3-.21-.62-.21-.95v-11.15h16.12c.39.95.97,1.85,1.71,2.7,1.64,1.85,3.93,2.79,6.88,2.79,2.61,0,4.8-.88,6.54-2.66,1.73-1.76,2.61-3.95,2.61-6.63s-.88-4.78-2.61-6.56ZM195.93,132.35h-19.61c2.93-8.27,5.87-16.56,8.8-24.83h.25c3.51,8.22,7,16.44,10.55,24.83ZM215.26,89.72c-.79.88-1.71,1.32-2.77,1.32s-2.06-.44-2.84-1.34c-.79-.9-1.18-1.99-1.18-3.26,0-1.18.42-2.17,1.2-3,.79-.85,1.73-1.27,2.82-1.27s1.99.46,2.77,1.34c.79.9,1.18,1.94,1.18,3.14s-.39,2.19-1.18,3.07Z"/> <path class="cls-4" d="M62.35,159.33H14.5c0,1.43-.02,2.68,0,3.93,0,4.78,2.93,7.71,7.67,7.71,10.42-.02,20.85-.05,31.27-.07.95,0,1.94-.05,2.86-.3,5.75-1.52,6.81-6.28,6.05-11.27Z"/> <path class="cls-4" d="M17.94,103.65c-.44-1.22-1.13-2.33-2.08-3.3-1.76-1.76-3.9-2.63-6.47-2.63-2.75,0-5.01.85-6.77,2.59s-2.63,3.97-2.63,6.7c0,2.4.81,4.53,2.45,6.4,1.64,1.85,3.93,2.79,6.88,2.79,2.61,0,4.78-.88,6.54-2.63.72-.74,1.27-1.52,1.71-2.4h18.61c0,3.28,0,6.58-.05,9.86,0,.65-.12,1.34-.32,1.94-3.42,9.72-6.88,19.4-10.3,29.12-.3.85-.65,1.11-1.52,1.11-2.98-.05-5.98,0-8.96.02-.97,0-1.39.39-1.39,1.27.02.88.46,1.27,1.52,1.27,2.84-.02,5.7-.07,8.54-.09,12.93-.07,25.89-.12,38.82-.16,1.2-.02,1.73-.44,1.71-1.32,0-.83-.49-1.2-1.66-1.2-2.45,0-4.92-.02-7.37.05-.69,0-1.04-.21-1.32-.88-4.09-9.7-8.22-19.38-12.33-29.08-.12-.3-.21-.65-.21-.97,0-3.63,0-7.3.02-10.95h29.01v64.48h7.51s0-71.98,0-71.98H17.94ZM12.06,110.07c-.81.88-1.71,1.32-2.77,1.32s-2.06-.44-2.84-1.34c-.79-.9-1.18-1.99-1.18-3.26,0-1.15.39-2.17,1.2-3,.79-.83,1.73-1.27,2.82-1.27s1.96.46,2.77,1.34c.79.9,1.18,1.94,1.18,3.14s-.39,2.22-1.18,3.07ZM49.49,152.98h-19.61c2.93-8.27,5.87-16.56,8.8-24.83.07,0,.16,0,.25-.02,3.49,8.22,6.97,16.47,10.55,24.85Z"/> <path class="cls-4" d="M99.67,26.6c-1.73-1.76-3.88-2.63-6.44-2.63-2.75,0-5.01.85-6.77,2.59-1.78,1.73-2.66,3.97-2.66,6.7,0,2.4.83,4.53,2.47,6.4.83.95,1.85,1.66,3.03,2.1v133.88h7.51V41.75c1.06-.44,2.01-1.09,2.86-1.96,1.76-1.76,2.61-3.95,2.61-6.63s-.85-4.78-2.61-6.56ZM95.86,36.33c-.79.88-1.71,1.32-2.75,1.32-1.11,0-2.06-.44-2.84-1.34-.79-.9-1.18-1.99-1.18-3.26,0-1.18.39-2.17,1.18-3,.79-.85,1.73-1.27,2.84-1.27,1.04,0,1.96.46,2.75,1.34.81.9,1.2,1.94,1.2,3.14s-.39,2.19-1.2,3.07Z"/> <path class="cls-4" d="M137.69,48.17c-1.73-1.76-3.9-2.66-6.47-2.66-2.75,0-5.01.88-6.77,2.61-1.76,1.73-2.63,3.95-2.63,6.7,0,2.4.81,4.53,2.45,6.4.83.95,1.85,1.64,3.03,2.1v112.31h7.51V63.32c1.06-.44,2.03-1.11,2.89-1.96,1.73-1.76,2.61-3.97,2.61-6.63s-.88-4.8-2.61-6.56ZM133.88,57.9c-.79.88-1.71,1.32-2.77,1.32s-2.06-.46-2.84-1.34c-.79-.9-1.18-1.99-1.18-3.26,0-1.18.39-2.17,1.2-3,.79-.85,1.73-1.27,2.82-1.27s1.99.44,2.77,1.34c.79.9,1.18,1.94,1.18,3.14s-.39,2.19-1.18,3.07Z"/> </g> </g> </svg> </a> </div> <div class="navbar-collapse collapse"> <ul class="nav navbar-nav navbar-right"> <li><a href="https://free.law/about/" tabindex="200">About</a></li> <li><a href="/faq/" tabindex="201">FAQ</a></li> <li class="visible-xs"> <a href="https://donate.free.law/forms/membership" tabindex="203">Become a Member</a> </li> <li> <a href="/sign-in/?next=/help/api/rest/citation-lookup/?" tabindex="204">Sign in / Register</a> </li> </ul> </div> </div> </div>  <div class="navbar navbar-default subnav white-background" role="navigation"> <div class="container-fluid"> <div> <ul class="nav navbar-nav"> <li class="dropdown active" id="navbar-o"> <a href="#" class="dropdown-toggle" tabindex="100" data-toggle="dropdown">Case Law <span class="caret"></span> </a> <ul class="dropdown-menu" role="menu"> <li> <a href="/opinion/" tabindex="101">Search Case Law</a> </li> <li> <a href="/c/" tabindex="102">Look Up Citations</a> </li> <li> <a href="/visualizations/scotus-mapper/" tabindex="102">Citation Visualizations</a> </li> <li> <a href="/help/coverage/opinions/" tabindex="103">About this Collection</a> </li> <li> <a href="/help/api/rest/case-law/" tabindex="104">API</a> </li> </ul> </li> <li class="dropdown inactive" id="navbar-r"> <a href="#" class="dropdown-toggle" tabindex="200" data-toggle="dropdown">RECAP Archive <span class="caret"></span> </a> <ul class="dropdown-menu" role="menu"> <li> <a href="/recap/" tabindex="201">Search PACER Data</a> </li> <li> <a href="https://free.law/recap/" tabindex="202">Install RECAP</a> </li> <li> <a href="/help/alerts/#recap-alerts" tabindex="204">Get Case Alerts</a> </li> <li> <a href="/help/coverage/recap/" tabindex="205">About this Collection</a> </li> <li> <a href="https://free.law/data-consulting/" tabindex="206">Bulk Data Service</a> </li> <li> <a href="/help/api/rest/pacer/" tabindex="207">API</a> </li> </ul> </li> <li class="dropdown inactive" id="navbar-oa"> <a href="#" class="dropdown-toggle" tabindex="300" data-toggle="dropdown">Oral Arguments <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> <a href="/audio/" tabindex="301">Search Oral Arguments</a> </li> <li> <a href="/help/alerts/#search-alerts" tabindex="302">Get Search Alerts</a> </li> <li> <a href="/podcasts/" tabindex="303">Custom Podcasts</a> </li> <li> <a href="/help/coverage/oral-arguments/" tabindex="304">About this Collection</a> </li> <li> <a href="/help/api/rest/oral-arguments/" tabindex="305">API</a> </li> </ul> </li> <li class="dropdown inactive" id="navbar-p"> <a href="#" class="dropdown-toggle" tabindex="400" data-toggle="dropdown">Judges <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> <a href="/person/" tabindex="401">Search Judges</a> </li> <li> <a href="https://free.law/projects/judge-db" tabindex="404">About this Collection</a> </li> <li> <a href="/help/api/rest/judges/" tabindex="405">API</a> </li> </ul> </li> <li class="dropdown inactive" id="navbar-fd"> <a href="#" class="dropdown-toggle" tabindex="500" data-toggle="dropdown">Financial Disclosures <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> <a href="/financial-disclosures/" tabindex="501">Search Financial Disclosures</a> </li> <li> <a href="/help/coverage/financial-disclosures/" tabindex="502">About this Collection</a> </li> <li> <a href="/help/api/rest/financial-disclosures/" tabindex="503">API</a> </li> </ul> </li> </ul> <ul class="nav navbar-nav navbar-right"> <li class="inactive hidden-xs"> <a href="https://donate.free.law/forms/membership" tabindex="600" class="donate"><i class="fa fa-heart-o"></i> Donate</a> </li> </ul> </div> </div> </div> </header> <div class="row content"> <div class="col-xs-12 hidden-md hidden-lg"> <h4 class="v-offset-below-2"> <i class="fa fa-arrow-circle-o-left gray"></i> <a href="/help/api/rest/v4">Back to API Docs</a> </h4> </div> <div id="toc-container" class="hidden-xs hidden-sm col-md-3"> <div id="toc"> <h4 class="v-offset-below-3"> <i class="fa fa-arrow-circle-o-left gray"></i> <a href="/help/api/rest/v4">Back to API Docs</a> </h4> <h3>Table of Contents</h3> <ul> <li><a href="#about">Overview</a></li> <li><a href="#usage">Using the API</a></li> <li><a href="#fields">Field Definitions</a></li> <li><a href="#limitations">Limitations & Throttles</a></li> <li><a href="#examples">API Examples</a></li> <ul> <li><a href="#basic">Basic, Valid Lookup</a></li> <li><a href="#failed">Failed Lookup</a></li> <li><a href="#throttled">Throttled Citations</a></li> <li><a href="#typoed">Typoed Reporter</a></li> <li><a href="#ambiguous">Ambiguous Citation</a></li> </ul> </ul> </div> </div> <div class="col-xs-12 col-md-8 col-lg-6"> <h1 id="about">Citation Lookup and Verification API</h1> <h2><code>/api/rest/v4/citation-lookup/</code></h2> <p class="lead v-offset-above-3">Use this API to look up citations in CourtListener's database of 17,771,679 citations.</p> <p>This API can look up either an individual citation or can parse and look up every citation in a block of text. This can be useful as a guardrail to help prevent hallucinated citations. </p> <p>This API uses <a href="https://free.law/projects/eyecite">Eyecite</a>, a tool we developed with <a href="https://lil.law.harvard.edu/">Harvard Library Innovation Lab</a> to parse legal citations. To develop Eyecite, we analyzed more than 50 million citations going back more than two centuries. We believe we have identified every reporter abbreviation in American case law and that there is no case law citation that Eyecite cannot properly parse and interpret. </p> <p>This API uses the same authentication and serialization methods as the rest of the CourtListener APIs. It does not support filtering, pagination, ordering, or field selection. </p> <h2 id="usage">Usage</h2> <p>The simplest way to query this API is to send it a blob of text. If the text does not have any citations, it will simply return an empty JSON object: </p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'text=Put some text here'\ []</pre> <p>If the text contains valid citations, it will return a list of the citations, analyzing each. This example contains a single citation that is found: </p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'text=Obergefell v. Hodges (576 U.S. 644) established the right to marriage among same-sex couples' [ { "citation": "576 U.S. 644", "normalized_citations": [ "576 U.S. 644" ], "start_index": 22, "end_index": 34, "status": 200, "error_message": "", "clusters": [...one large cluster object here...] } ]</pre> <p>If you have the volume, reporter, and page for a citation, you can look it up as follows: </p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'volume=576' \ --data 'reporter=U.S.' \ --data 'page=644'</pre> <p>That returns the same response as above.</p> <h2 id="fields">Field Definitions</h2> <p>The fields returned by this API are:</p> <ul> <li><p><code>citation</code> — The citation you looked up. If you supplied the volume, reporter, and page, they will appear here as a single space-separated string.</p></li> <li><p><code>normalized_citations</code> — Normalized versions of your citation if it contains a typo or if it is not the canonical (standard) abbreviation for a reporter. If the citation queried is ambiguous, more than one item can appear in this field. See examples below.</p></li> <li><p><code>start_index</code> & <code>end_index</code> — These fields indicate the start and end positions where a citation is found in the text queried.</p></li> <li><p><code>status</code> — indicates the outcome of a citation lookup. Its values correspond to HTTP status codes and can have one of five values:</p></li> <ul> <li><p><code>200 (OK)</code> — We found a citation, it was valid, and we were able to look it up in CourtListener.</p></li> <li><p><code>404 (Not Found)</code> — We found a citation, it was valid, but we were unable to look it up in CourtListener.</p></li> <li><p><code>400 (Bad Request)</code> — We found something that looks like a citation, but the reporter in the citation wasn’t in our system (e.g., “33 Umbrella 422” looks like a citation, but is not valid).</p></li> <li><p><code>300 (Multiple Choices)</code> — We found a valid citation, it was valid, but it matched more than one item in CourtListener.</p></li> <li><p><code>429 (Too Many Requests)</code> — This API will only lookup 250 citations in a single request. Any citations after that point will have this status. They will be identified but will not be looked up. (See throttles below)</p></li> </ul> <li><p><code>error_message</code> — This field will contain additional details about any problems the lookup encounters.</p></li> <li> <p><code>clusters</code> — This is a list of the CourtListener <a href="/help/api/rest/#cluster-endpoint">cluster objects</a> that match the citation in your query. This key will contain multiple values when a citation matches more than one legal decision. This can happen when a citation is ambiguous or when multiple decisions are on a single page in a printed book (and thus share the same citation).</p> </li> </ul> <h2 id="limitations">Limitations & Throttles</h2> <p>This API has four limitations on how much it can be used: </p> <ol> <li><p>The performance of this API is affected by the number of citations it has to look up. Therefore, it is throttled to 60 valid citations per minute. If you are below this throttle, you will be able to send a request to the API. If a request pushes you beyond this throttle, further requests will be denied. When your request is denied, the API will respond with a 429 HTTP code and a JSON object. The JSON object will contain a <code>wait_util</code> key that uses an ISO-8601 datetime to indicate when you will be able to make your next request. </p></li> <li><p>The API will look up at most 250 citations in any single request. Any citations past that point will be parsed, but not matched to the CourtListener database. The <code>status</code> key of such citations will be 429, indicating “Too many citations requested.” See examples below for details. </p></li> <li><p>Text lookup requests to this API can only contain 64,000 characters at a time. Requests with more than this amount will be blocked for security. This is about 50 pages of legal content. </p></li> <li><p>To prevent denial of service attacks that do not contain any citations, this API has the same request throttle rates as the other CourtListener APIs. This way, even requests that do not contain citations can be throttled. (Most users will never encounter this throttle.) </p></li> </ol> <p>A few other limitations to be aware of include:</p> <ol> <li><p>This API does not look up statutes, law journals, id, or supra citations. If you wish to match such citations, please use Eyecite directly.</p></li> <li><p>This API will not attempt to match citations without volume numbers or page numbers (e.g. 22 U.S. ___). </p></li> </ol> <h2 id="examples">API Examples</h2> <h3 id="basic">Basic, Valid Lookup</h3> <p>The following is a basic lookup using the <code>text</code> parameter and a block of text:</p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'text=Obergefell v. Hodges (576 U.S. 644) established the right to marriage among same-sex couples' [ { "citation": "576 U.S. 644", "normalized_citations": [ "576 U.S. 644" ], "start_index": 22, "end_index": 34, "status": 200, "error_message": "", "clusters": [...one cluster here...] } ]</pre> <h3 id="failed">Failed Lookup</h3> <p>This query uses the volume-reporter-page triad, but fails because the citation does not exist:</p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'volume=1' \ --data 'reporter=U.S.' \ --data 'page=200' [ { "citation": "1 U.S. 200", "normalized_citations": [ "1 U.S. 200" ], "start_index": 0, "end_index": 10, "status": 404, "error_message": "Citation not found: '1 U.S. 200'", "clusters": [] } ]</pre> <p>Note that:</p> <ol> <li><p>The <code>status</code> field is set to 404 indicating the citation was not found.</p></li> <li><p>The <code>start_index</code> is 0, and the <code>end_index</code> is the length of the citation including space separators.</p></li> <li><p>The <code>error_message</code> field provides details of the error.</p></li> </ol> <h3 id="throttled">Throttled Citations</h3> <p>If your request contains more than 250 citations, the 251<sup>st</sup> and subsequent citations will be returned with 429 <code>status</code> fields: </p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'text=Imagine a very long blob here, with 251 citations.' [ ...250 citations would appear here, then the 251st and subsequent citations would be... { "citation": "576 U.S. 644", "normalized_citations": [ "576 U.S. 644" ], "start_index": 10002, "end_index": 10013, "status": 429, "error_message": "Too many citations requested.", "clusters": [] } ]</pre> <p>Note that:</p> <ol> <li><p>All citations will be parsed and will provide normalized versions and index locations.</p></li> <li><p>Citations after the 250<sup>th</sup> will return a <code>status</code> of 429, indicating "Too many citations requested."</p></li> <li><p>A follow-up query that begins on the 251<sup>st</sup> <code>start_index</code> (in this case number 10002) will look up the next 250 items.</p></li> </ol> <h3 id="typoed">Typoed/Non-Canonical Reporter Abbreviation</h3> <p>If you query the non-canonical reporter abbreviation or if your reporter contains a known typo, we will provide the corrected citation in the <code>normalized_citations</code> key. The following example looks up a citation using "US" instead of the correct "U.S.": </p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'text=576 US 644' [ { "citation": "576 US 644", "normalized_citations": [ "576 U.S. 644" ], "start_index": 1, "end_index": 11, "status": 200, "error_message": "", "clusters": [...one cluster here...] } ]</pre> <h3 id="ambiguous">Ambiguous Citation</h3> <p>This lookup is for an ambiguous citation abbreviated as "H." This reporter abbreviation can refer to Handy's Ohio Reports, the Hawaii Reports, or Hill’s New York Reports. Only two of those reporter series have cases at the queried volume and page number, so the API returns two possible matches for the citation: </p> <pre class="pre-scrollable">curl -X POST "https://www.courtlistener.com/api/rest/v4/citation-lookup/" \ --header 'Authorization: Token <your-token-here>' \ --data 'text=1 H. 150' [ { "citation": "1 H. 150", "normalized_citations": [ "1 Handy 150", "1 Haw. 150", "1 Hill 150" ], "start_index": 0, "end_index": 8, "status": 300, "clusters": [ { ... "citations": [{ "volume": 1, "reporter": "Handy", "page": "150", "type": 2 }], ... "case_name": "Louis v. Steamboat Buckeye", ... }, { ... "citations": [{ "volume": 1, "reporter": "Haw.", "page": "150", "type": 2 }], ... "case_name": "Fell v. Parke", ... } ] } ]</pre> <p>Note that:</p> <ol> <li><p>The <code>normalized_citations</code> field returned three possible values for the ambiguous query.</p></li> <li><p>The <code>status</code> field returned a 300 code, indicating "Multiple Choices."</p></li> <li><p>There are two different objects returned in the <code>clusters</code> field.</p></li> </ol> <div class="well v-offset-above-3"> <h2 class="top text-center">Please Support Open Legal Data</h2> <p>These services are sponsored by <a href="https://free.law">Free Law Project</a> and users like you. We provide these services in furtherance of our mission to make the legal sector more innovative and equitable. </p> <p>We have provided these services for over a decade, and we need your contributions to continue curating and enhancing them. </p> <p>Will you support us today by becoming a member?</p> <div class="row"> <div class="hidden-xs col-sm-1 col-md-2 col-lg-3"></div> <div class="col-xs-12 col-sm-10 col-md-8 col-lg-6"> <p class="text-center"> <a href="https://donate.free.law/forms/membership" class="btn btn-lg btn-block btn-danger"><i class="fa fa-heart-o"></i> Join FLP</a> </p> </div> </div> </div> </div> </div> <div class="row base-newsletter hidden-print"> <div class="col-sm-6"> <p class="bold bottom">Newsletter</p> <p>Sign up to receive the Free Law Project newsletter with tips and announcements.</p> </div> <div class="col-sm-6 right"> <a href="https://donate.free.law/np/clients/freelawproject/subscribe.jsp?forwardedFromSecureDomain=1&subscription=9" class="btn btn-default" tabindex="10000"> <i class="fa fa-newspaper-o"></i> Subscribe </a> </div> </div> <footer class="row hidden-print"> <div class="col-sm-8"> <div class="row"> <div class="col-xs-6"> <div class="col-sm-6 no-gutter"> <div class="footer-item"> <a href="https://free.law/about/" tabindex="11000">About</a> </div> <div class="footer-item"> <a href="/help/" tabindex="11001">Help</a> & <a href="/faq/">FAQ</a> </div> <div class="footer-item"> <a href="https://donate.free.law/forms/membership" tabindex="11002">Donate</a> </div> </div> <div class="col-sm-6 no-gutter"> <div class="footer-item"> <a href="/help/coverage/" tabindex="11003">About Our Data</a> </div> <div class="footer-item"> <a href="/help/api/" tabindex="11004">APIs & Bulk Data</a> </div> <div class="footer-item"> <a href="/feeds/" tabindex="11005">Feeds</a> <span class="alt">&</span> <a href="/podcasts/" tabindex="11006">Podcasts</a> <i class="gray fa fa-podcast inline"></i> </div> </div> </div> <div class="col-xs-6"> <div class="col-sm-6 no-gutter"> <div class="footer-item"> <a href="https://free.law" tabindex="11007">Blog Posts</a> </div> <div class="footer-item"> <a href="/contact/" tabindex="11008">Contact</a> </div> <div class="footer-item"> <a href="https://free.law/data-consulting/" tabindex="11009">Data Services</a> </div> <div class="footer-item"> <a href="/contribute/" tabindex="11010">Contribute</a> </div> </div> <div class="col-sm-6 no-gutter"> <div class="footer-item"> <a href="/terms/" tabindex="11011">Terms & Privacy</a> </div> <div class="footer-item"> <a href="/terms/#removal" tabindex="11012">Removal</a> </div> <div class="footer-item"> <a href="https://free.law/vulnerability-disclosure-policy/" tabindex="11013">Vulnerability Policies</a> </div> </div> </div> </div> </div> <div class="col-sm-4 text-right" id="donate-image"> <a href="https://donate.free.law/forms/membership" tabindex="11014"> <img src="https://storage.courtlistener.com/static/png/donate-button.f21707e5ec7d.png" alt="Donate to support our work" height="75" width="227"> </a> </div> <div class="col-sm-12" id="by-line"> <p>CourtListener is sponsored by the non-profit <a href="https://free.law" tabindex="11015">Free Law Project</a>.</p> </div> </footer> </div> <div class="text-center hidden-print" id="social-container"> <a href="https://free.law/" class="fa-stack fa-lg" tabindex="12000"> <i class="fa fa-circle fa-stack-2x gray"></i> <i class="fa fa-link fa-stack-1x fa-inverse"></i> </a> <a href="https://x.com/freelawproject" rel="noreferrer" class="fa-stack fa-lg" tabindex="12001"> <i class="fa fa-circle fa-stack-2x gray"></i> <i class="fa fa-twitter fa-stack-1x fa-inverse"></i> </a> <a href="https://donate.free.law/np/clients/freelawproject/subscribe.jsp?subscription=9" class="fa-stack fa-lg" tabindex="12002"> <i class="fa fa-circle fa-stack-2x gray"></i> <i class="fa fa-newspaper-o fa-stack-1x fa-inverse"></i> </a> <a href="https://github.com/freelawproject/courtlistener" rel="noreferrer" class="fa-stack fa-lg" tabindex="12003"> <i class="fa fa-circle fa-stack-2x gray"></i> <i class="fa fa-github fa-stack-1x fa-inverse"></i> </a> </div> <script type="text/javascript" src="https://storage.courtlistener.com/static/js/jquery/jquery-3.4.1.min.220afd743d9e.js"></script> <script type="text/javascript" src="https://storage.courtlistener.com/static/js/bootstrap.min.6c1ad0cd7c72.js"></script> <script type="text/javascript" src="https://storage.courtlistener.com/static/js/base.f78fd1a1bbda.js"></script> <script type="text/javascript" nonce="5YhDpq3YT//ZUi3wOpstuA=="> var isMember = false, userAlertCount = 0, priceRtAlerts = parseFloat(10), maxFreeDocketAlerts = 5, recapBonusAlerts = 10; </script> <script src="https://storage.courtlistener.com/static/js/anchor.min.64dff6848f1c.js"></script> <script type="text/javascript" nonce="5YhDpq3YT//ZUi3wOpstuA=="> $(document).ready(function () { anchors.options = { 'visible': 'touch', 'class': 'gray' }; anchors.add(); }); </script> </body> </html>

CINXE.COM

Citation Lookup and Verification API – CourtListener.com