Template:Cite Pacer/doc

From blackwiki
Jump to navigation Jump to search

Usage

The Cite Pacer template generates a citation for the PDF from a recent US Federal Court Case, archived for free by the Recap browser plugin at the Internet Archive based on copyright-free original public documents made available by the US Government's PACER Service. As with other citation templates, this template can be used either in a footnote (between <ref>...</ref> tags) or in a section that lists sources.

If the correct parameters are used, this template produces output via the general purpose citation template, {{Citation}}.

Each case is assigned a number in the format D:YY-TT-SSSSS where D=Division Office (most districts are split into divisions), YY=Year, TT=Type (e.g. bk=bankruptcy, cv=civil, cr=criminal), SSSSS=Sequence number. The case number does not contain any type of court identifier, so a two-letter state abbreviation is needed, and when a state has multiple Federal districts, a two-letter abbreviation is needed to further disambiguate which court the case is in.

The CM/ECF database system assigns a unique number to cases in each court, and it is this pacer-number which is used for direct linking to cases. Recap also takes advantage of this unique identifier.

Regardless of which citation templates are used or even if none are used at all, all citations should have the same format throughout an article in the saved, rendered text.

Note: All parameter names must be lowercase.

Simple citations

This section covers all parameters. You can copy the horizontal form or vertical form below and then remove extra parameters from the full list. Spacing and ordering of the parameters within the template is irrelevant and does not affect the final, rendered text.

{{Cite Pacer |plaintiff= |defendant= |title= |date= |case-division= |case-year= |case-type= |case-sequence= |case-state= |case-district= |doc-number= |att-number= |pacer-number= |access-date= |use-pacer= |use-recap= |case-title= |recap-number= |ref= }}

{{Cite Pacer
| plaintiff =
| defendant =
| title =
| date = 
| case-division = 
| case-year = 
| case-type = 
| case-sequence = 
| case-state = 
| case-district = 
| doc-number =
| att-number =
| pacer-number =
| access-date = 
| use-pacer =
| use-recap =
| case-title =  
| recap-number =
| ref = 
}}
  • Required Parameters
    • plaintiff: The Lead Plaintiff, used to build ref and case-title if not set
    • defendant: The Lead Defendant, used to build ref and case-title if not set
    • title: The title of the filing
    • date: date case was filed
    • case-division: The location within the district (division office) where the court is held.
    • case-year: The year or last two digits of the year the case was filed. Additional letters may be appended to disambiguation cases filed the same year.
    • case-type: "cv" for civil case, "cr" for criminal cases, "bk" for bankruptcy cases.
    • case-sequence: The clerk's serial number for the case within the section and year.
    • case-state: Two-letter abbreviation for state. Use dc or DC for District of Columbia
    • case-district: 1- or 2-letter abbreviation for which Federal district the court is in, optional if the state has only one district. Use "sd" for Southern District, "cd" for Central District, etc.
    • doc-number: The docket number of the filing
  • Optional Parameters
    • att-number: The attachment number of the filing if this is not the main document. OPTIONAL
    • pacer-number: The electronic filing number for the case; unique within a district. OPTIONAL
    • access-date: Date when the online docket was accessed. ILLEGAL if pacer-number and recap-number both unset
    • use-recap: Link to Recap if either recap-number or pacer-number is set. "no" is the only useful non-default value. OPTIONAL
    • use-pacer: Link to PACER if pacer-number is set. "no" is the only useful non-default value. OPTIONAL
    • case-title: The name of the case, optional if plaintiff and defendant set OPTIONAL
    • recap-number: The database number for the case, not needed if pacer-number is set. But if only this is set, only a Recap link can be made. OPTIONAL
    • ref: The name by which this citation may be short-linked to, optional if plaintiff and defendant set OPTIONAL

Examples

{{Cite Pacer
| plaintiff = CREW
| defendant = Trump
| title = Complaint
| doc-number = 1
| date = Jan 23, 2017
| case-division = 1
| case-year = 2017
| case-type = cv
| case-sequence = 00458
| case-state = NY
| case-district = sd
| recap-number = 467802
| access-date = Jul 14, 2017
}}
"Complaint" (PDF), CREW v. Trump (Court Filing), S.D.N.Y., No. 1:17-cv-00458 (Docket 1), Jan 23, 2017, retrieved Jul 14, 2017 – via Recap
{{Cite Pacer
| plaintiff = CREW
| defendant = Trump
| title = Complaint
| doc-number = 1
| date = Jan 23, 2017
| case-division = 1
| case-year = 2017a
| case-type = cv
| case-sequence = 00458
| case-state = NY
| case-district = sd
| pacer-number = 467802
| access-date = Jul 14, 2017
}}
"Complaint" (PDF), CREW v. Trump (Court Filing), S.D.N.Y., No. 1:17-cv-00458 (Docket 1), Jan 23, 2017, retrieved Jul 14, 2017 – via Recap (PACER current docket viewPaid subscription required)
{{Cite Pacer
| plaintiff = CREW
| defendant = Trump
| date = Jan 23, 2017
| title = Complaint
| doc-number = 1
| case-year = 2017b
| case-type = cv
| case-sequence = 00458
| case-state = NY
| case-district = sd
| pacer-number = 467802
| access-date = Jul 14, 2017
| use-pacer = no
}}
"Complaint" (PDF), CREW v. Trump (Court Filing), S.D.N.Y., No. 1:17-cv-00458 (Docket 1), Jan 23, 2017, retrieved Jul 14, 2017 – via Recap
{{Cite Pacer
| plaintiff = CREW
| defendant = Trump
| title = Complaint
| doc-number = 1
| date = Jan 23, 2017
| case-division = 1
| case-year = 2017c
| case-type = cv
| case-sequence = 00458
| case-state = NY
| case-district = sd
| pacer-number = 467802
| access-date = Jul 14, 2017
| use-recap = no
}}
"Complaint", CREW v. Trump (Court Filing), S.D.N.Y., No. 1:17-cv-00458 (Docket 1), Jan 23, 2017 (PACER current docket viewPaid subscription required)
{{Cite Pacer
| plaintiff = CREW
| defendant = Trump
| title = Complaint
| doc-number = 1
| date = Jan 23, 2017
| case-division = 1
| case-year = 2017d
| case-type = cv
| case-sequence = 00458
| case-state = NY
| case-district = sd
| pacer-number = 467802
| access-date = Jul 14, 2017
| use-pacer = no
| use-recap = no
}}
"Complaint", CREW v. Trump (Court Filing), S.D.N.Y., No. 1:17-cv-00458 (Docket 1), Jan 23, 2017
{{Cite Pacer
| plaintiff = CREW
| defendant = Trump
| title = Complaint
| doc-number = 1
| date = Jan 23, 2017
| case-division = 1
| case-year = 17e
| case-type = cv
| case-sequence = 00458
| case-state = Ny
| case-district = Sd
}}
"Complaint", CREW v. Trump (Court Filing), S.D.N.Y., No. 1:17-cv-00458 (Docket 1), Jan 23, 2017


Comparison of template parameters

Parameter Court Filings Court Dockets Notes
{{cite Pacer}} {{PacerRef}} {{cite Pacer Docket}} {{PacerRef}}


access-date Optional Ignored Optional Ignored Date Filing or Docket was confirmed to exist on Recap and support text of article
at Ignored Optional Ignored Ignored Paragraph name of specific citation
att-number Optional Optional Ignored Ignored Attachment Number, for linking to PDF of attachment to main filing. Defaults to 0 for the main filing.
case-district Optional Optional Optional Optional 1- or 2- letter of abbreviation of district within a state. Defaults to "d" for when a state has no division into multiple districts.
case-division Required Optional Required Optional Number of a division within a particular court.
case-prefix Optional Optional Optional Optional Defaults to "No."
case-sequence Required Optional Required Optional Clerk-assigned sequence number for a particular division within a particular court during a particular year
case-state Required Optional Required Optional Two-letter official abbreviation of state (or D.C. for District of Columbia. Required for linking to documents.
case-title Optional Optional Optional Optional Name of the case, defaults to plaintiff v. defendant
case-type Required Optional Required Optional Format is a pair of lowercase letters
case-year Required Required3 Required Required3 Format is year (2- or 4-digits) followed by optional alphabetic distinguisher
date Required Optional Required Optional Date document filed or for dockets, date case began
defendant Required Required2 Required Required2 Short form of lead defendant
doc-number Required Optional Ignored Ignored Set to docket number of PDF document
docket Ignored Optional4 Ignored Required4 Defaults to .doc-number.att-number for documents. Set to "yes" or "Docket" for dockets
pacer-number Optional Ignored Optional Ignored Allows linking to live subscription docket
page Ignored Optional Ignored Ignored Ignored if at or pages is set
pages Ignored Optional Ignored Ignored Hyphenated page range. Ignored if at is set


pdf-page Ignored Optional Ignored Ignored Number of actual page of PDF, regardless of human-readable numbering. Defaults to page
plaintiff Required Required1 Required Required1 Short form of lead plaintiff


recap-number Optional Optional Optional Ignored Required to link to PDF or free (Recap) docket. Defaults to pacer-number
ref Optional Optional Optional Optional Anchor name of long form citation. Should only be used if default scheme breaks down
title Required Required Optional Required5 Full or short document title; for dockets defaults to plaintiff v. defendant
use-pacer Optional Ignored Optional Ignored "no" prevents linking to Subscription-based Docket
use-recap Optional Optional Optional Ignored "no" prevents linking to PDF of filing or HTML of Docket

1{{PacerRef}} uses positional parameter 1 as a short-hand for plaintiff

2{{PacerRef}} uses positional parameter 2 as a short-hand for defendant

3{{PacerRef}} uses positional parameter 3 as a short-hand for case-year

4{{PacerRef}} uses positional parameter 4 as a short-hand for docket

5{{PacerRef}} uses positional parameter 5 as a short-hand for title


Cite a filing or attachment to a filing in US Federal District Court Case, and optional link to Recap free archive and/or PACER non-free current Docket.

Template parameters

ParameterDescriptionTypeStatus
Lead Plaintiffplaintiff

Short name for Lead Plaintiff

Example
CREW
Stringrequired
Lead Defendantdefendant

Short name for Lead Defendant

Example
Trump
Stringrequired
Case Namecase-title

Name of Case, listing at least one plaintiff and defendant, each

Default
{{{plaintiff}}} v. {{{defendant}}}
Example
CREW v. Trump
Auto value
{{{plaintiff}}} v. {{{defendant}}}
Contentoptional
Document/Attachment Nametitle

Display name for Document or Attachment

Example
Brief for Scholar Seth Barrett Tillman as Amicus Curiae in Support of the Defendant
Contentrequired
Document Numberdoc-number

Serial number of filing in official court docket

Example
37
Numberrequired
Attachment numberatt-number

Attachment number or 0 for main document of a filing

Default
0
Example
1
Unknownoptional
Date of Filingdate

When the Document was filed with the clerk of the court

Example
Jan 23, 2017
Auto value
Daterequired
PACER Numberpacer-number

PACER/Recap database number of case within District

Example
467802
Numbersuggested
Use PACER?use-pacer

Set to no to avoid linking to docket when PACER number is set

Default
yes
Example
no
Booleanoptional
Recap numberrecap-number

Recap database number, defaults to PACER number

Example
467802
Numberoptional
Use Recap?use-recap

Set to no to avoid linking to Recap if pacer-number or recap-number set

Example
no
Auto value
Booleansuggested
Case Number Prefixcase-prefix

Label to place in front of Case Number

Example
No.
Contentoptional
Statecase-state

Two-letter official abbreviation of State of the US Federal Court

Example
NY
Stringrequired
Districtcase-district

One- or two-letter abbreviation of district within a State of the US Federal Court

Default
D
Example
SD
Stringsuggested
Divisioncase-division

Number to indication which division of the district where the case was filed

Default
1
Example
1
Numberrequired
Case Yearcase-year

The two- or four-digit year in which the case was filed and any optional alphabetic reference distinguisher needed

Example
2017a
Stringrequired
Case Typecase-type

Use cv for Civil, cr for Criminal, and bk for Bankruptcy

Example
cv
Stringrequired
Case Sequence Numbercase-sequence

Unique identifier issued by the clerk within division, type and year

Example
00458
Stringrequired
Access-dateaccess-date

Date Recap document was confirmed to support article

Datesuggested
Reference Nameref

Name for this citation used for intra-page linking, as per PacerRef template

Stringoptional