Template:Cite Pacer Docket/sandbox

This is the template sandbox page for Template:Cite Pacer Docket (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

Usage

The Cite Pacer Docket template generates a citation for a recent US Federal Court Case (or rather the electronic docket thereof) 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 Docket |plaintiff= |defendant= |date= |case-division= |case-year= |case-type= |case-sequence= |case-state= |case-district= |pacer-number= |access-date= |use-pacer= |use-recap= |case-title= |recap-number= |ref= }}

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

Required Parameters
- plaintiff: The Plaintiff, used to build ref and case-title if not set
- defendant: The Defendant, used to build ref and case-title if not set
- 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.
Optional Parameters
- 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 Docket \| plaintiff = CREW \| defendant = Trump \| 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 }}	CREW v. Trump (Docket Report), S.D.N.Y., Jan 23, 2017, no. 1:17-cv-00458, retrieved Jul 14, 2017 – via Recap
{{Cite Pacer Docket \| plaintiff = CREW \| defendant = Trump \| 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 }}	CREW v. Trump (Docket Report), S.D.N.Y., Jan 23, 2017, no. 1:17-cv-00458, retrieved Jul 14, 2017 – via Recap (PACER current view)
{{Cite Pacer Docket \| plaintiff = CREW \| defendant = Trump \| date = Jan 23, 2017 \| case-division = 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 }}	CREW v. Trump (Docket Report), S.D.N.Y., Jan 23, 2017, no. 1:17-cv-00458, retrieved Jul 14, 2017 – via Recap
{{Cite Pacer Docket \| plaintiff = CREW \| defendant = Trump \| 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 }}	CREW v. Trump (Docket Report), S.D.N.Y., Jan 23, 2017, no. 1:17-cv-00458, retrieved Jul 14, 2017 – via PACER
{{Cite Pacer Docket \| plaintiff = CREW \| defendant = Trump \| 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 }}	CREW v. Trump (Docket Report), S.D.N.Y., Jan 23, 2017, no. 1:17-cv-00458
{{Cite Pacer Docket \| plaintiff = CREW \| defendant = Trump \| date = Jan 23, 2017 \| case-division = 1 \| case-year = 17e \| case-type = cv \| case-sequence = 00458 \| case-state = Ny \| case-district = Sd }}	CREW v. Trump (Docket Report), S.D.N.Y., Jan 23, 2017, no. 1:17-cv-00458

Cite the Docket to a US Federal District Court Case, and optionally link to Recap free archive and/or PACER non-free current Docket.

Template parameters[Edit template data]
Parameter		Description	Type	Status
Lead Plaintiff	`plaintiff`	Short name for Lead Plaintiff Example CREW	String	required
Lead Defendant	`defendant`	Short name for Lead Defendant Example Trump	String	required
Case Name	`case-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}}}`	Content	optional
Date of Filing	`date`	When the Document was filed with the clerk of the court Example Jan 23, 2017 Auto value	Date	required
PACER Number	`pacer-number`	PACER/Recap database number of case within District Example 467802	Number	suggested
Use PACER?	`use-pacer`	Set to no to avoid linking to docket when PACER number is set Default yes Example no	Boolean	optional
Recap number	`recap-number`	Recap database number, defaults to PACER number Example 467802	Number	optional
Use Recap?	`use-recap`	Set to no to avoid linking to Recap if pacer-number or recap-number set Example no Auto value	Boolean	suggested
Case Number Prefix	`case-prefix`	Label to place in front of Case Number Example No.	Content	optional
State	`case-state`	Two-letter official abbreviation of State of the US Federal Court Example NY	String	required
District	`case-district`	One- or two-letter abbreviation of district within a State of the US Federal Court Default D Example SD	String	suggested
Division	`case-division`	Number to indication which division of the district where the case was filed Default 1 Example 1	Number	required
Case Year	`case-year`	The two- or four-digit year in which the case was filed and any optional alphabetic reference distinguisher needed Example 2017a	String	required
Case Type	`case-type`	Use cv for Civil, cr for Criminal, and bk for Bankruptcy Example cv	String	required
Case Sequence Number	`case-sequence`	Unique identifier issued by the clerk within division, type and year Example 00458	String	required
access-date	`access-date`	Date Recap document was confirmed to support article	Date	suggested
Reference Name	`ref`	Name for this citation used for intra-page linking	String	optional

The above documentation is transcluded from Template:Cite Pacer Docket/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.