EOIR Automated Case Information – Immigration Court Case Lookup

Look up immigration court case information from the Executive Office for Immigration Review (EOIR) by A-Number and nationality. Instantly retrieve hearing dates, case status, appeal details, judge information, court location, scheduling data, and motion-to-reopen status. Get real-time EOIR case data in structured JSON, CSV, or Excel format.

---

Table of Contents

• Features
• Use Cases
• Quick Start
• Input Parameters
• Output Format
• Output Fields Explained
• Performance & Limits
• FAQ
• Troubleshooting
• Tags

---

Features

• A-Number Lookup – Look up any immigration court case using the 9-digit Alien Registration Number (A-Number).
• Real-Time Case Data – Get the latest hearing dates, case status, and court information directly from EOIR.
• Complete Hearing Schedule – Extract next hearing date, time, hearing medium (in-person/video), and calendar type.
• Judge Information – Get the assigned Immigration Judge (IJ) name, code, and WebEx hearing URL.
• Court Location Details – Full hearing location address, city code, and contact information.
• Appeal Tracking – Track appeal status, BIA decisions, brief filing dates, and deadlines.
• Motion to Reopen (MTR) – Monitor motion-to-reopen/reconsider filings, decisions, and dates.
• Case Proceeding Details – Case type (removal, deportation), generation, decision codes, and completion dates.
• Structured Output – Clean, flat JSON structure ready for analysis, databases, or spreadsheets.

---

Use Cases

Use Case	Description	Key Benefits
Immigration Case Tracking	Monitor the status and hearing schedule of immigration court cases.	Stay updated on next hearing dates, judge assignments, and case decisions.
Legal Practice Management	Automate case lookups for law firms handling immigration cases.	Reduce manual EOIR phone system calls and save hours of administrative time.
Case Status Monitoring	Set up periodic checks on case progress and hearing changes.	Get alerts on rescheduled hearings, new decisions, or appeal deadlines.
Data Analysis & Research	Collect structured immigration court data for research and analysis.	Analyze court backlogs, hearing timelines, and decision patterns.
Client Communication	Retrieve case details to share updates with clients.	Provide accurate, real-time hearing dates and court location info.
Appeal & MTR Tracking	Track appeal filings, BIA decisions, and motion-to-reopen status.	Never miss a brief deadline or appeal filing date.

---

Quick Start

1. Basic – Simple Case Lookup

{
  "a_number": "245339291",
  "nationality": "Colombia"
}

2. Another Example – Different Nationality

{
  "a_number": "246776314",
  "nationality": "Dominican Republic"
}

---

Input Parameters

Parameter	Type	Required	Description	Default	Example
a_number	String	Yes	9-digit Alien Registration Number (A-Number). Numbers only, no dashes or spaces.	-	"245339291", "246776314"
nationality	String	Yes	Nationality / country of origin of the individual.	-	"Colombia", "Dominican Republic", "Mexico"

---

Output Format

Case Information Data Structure

{
  "source": "eoir_case_information",
  "a_number": "245339291",
  "nationality": "Colombia",
  "language": "EN",

  "alien_name": "RODRIGUEZ- SANTIAGO, WILSON ANTONIO",
  "case_id": 12715898,
  "valid_alien_number": true,
  "clock_status": "S",
  "elapsed_days": "623",

  "next_hearing_date": "2026-08-03T00:00:00",
  "next_hearing_time": "8:30 AM",
  "latest_cal_type": "M",
  "docket_date": "2023-12-01T00:00:00",
  "osc_date": "2023-10-09T00:00:00",

  "case_contact_info": "150 APOLLO DRIVE, STE 100|CHELMSFORD, MA 01824|9784979000",

  "case_decision": null,
  "appeal_decision": null,
  "mtr_decision_string": null,
  "reopen_decision": null,

  "appeal_filed": false,
  "case_appeal_exists": false,
  "pending_at_bia": false,
  "mtr_bia_appeal": false,
  "mtr_bia_type": null,
  "reopen_exists": false,

  "appeal_type": null,
  "appeal_filed_date": null,
  "alien_brief_due": null,
  "alien_brief_filed": null,
  "dhs_brief_due": null,
  "dhs_brief_filed": null,
  "bia_decision": null,
  "bia_decision_date": null,

  "mtr_appeal_filed_date": null,
  "mtr_decision": null,
  "mtr_decision_date": null,

  "case_type": "RMV",
  "base_city_code": "CHE",
  "generation": "98",
  "subgeneration": null,
  "hearing_location_code": "CHE",
  "hearing_location": "CHELMSFORD - NONDETAINED|150 APOLLO DRIVE, SUITE 100|CHELMSFORD, MA 01824",
  "ij_code": null,
  "ij_name": null,
  "decision_code": null,
  "comp_date": null,
  "date_appeal_due": null,
  "battered_spouse": false,
  "release_info": "Y",
  "contact_address": null,

  "reopen_motion_received_date": null,
  "reopen_comp_date": null,
  "reopen_decision_detail": null,

  "schedule_adj_date": "2026-08-03T00:00:00",
  "schedule_adj_time": "8:30 AM",
  "schedule_cal_type": "M",
  "schedule_type": "MR",
  "schedule_hearing_medium": "P",
  "schedule_hearing_location_code": "CHE",
  "schedule_hearing_location": "CHELMSFORD - NONDETAINED|150 APOLLO DRIVE, SUITE 100|CHELMSFORD, MA 01824",
  "schedule_contact_address": "150 APOLLO DRIVE, STE 100|CHELMSFORD, MA 01824|9784979000",
  "schedule_proceeding_id": 15880391,

  "judge_code": "CEO",
  "judge_name": "Olson, Christine",
  "judge_webex_url": "HTTPS://EOIR.WEBEX.COM/MEET/IJ.CHRISTINE.OLSON",

  "cached": false,
  "case_status": "found",
  "api_time_taken_seconds": 8.68,

  "scraped_at": "2026-07-21T06:09:32.601Z"
}

---

Output Fields Explained

Case Identification

Field	Type	Description
source	String	Source indicator, always eoir_case_information
a_number	String	The 9-digit Alien Registration Number used for the lookup
nationality	String	Nationality / country of origin provided in the input
language	String	Language code of the case (e.g., EN for English)

Case Basic Information

Field	Type	Description
alien_name	String	Full name of the individual (Last, First Middle)
case_id	Integer	Unique EOIR case identifier
valid_alien_number	Boolean	Whether the A-Number is valid in the EOIR system
clock_status	String	Case clock status (S = Stopped, R = Running)
elapsed_days	String	Number of days since the case was docketed

Hearing Information

Field	Type	Description
next_hearing_date	String	Date of the next scheduled hearing (ISO format)
next_hearing_time	String	Time of the next scheduled hearing (e.g., 8:30 AM)
latest_cal_type	String	Calendar type of the latest hearing (M = Master, I = Individual)
docket_date	String	Date the case was docketed (ISO format)
osc_date	String	Order to Show Cause (NTA) date (ISO format)
case_contact_info	String	Court contact address and phone number (pipe-separated)

Case Decision & Status

Field	Type	Description
case_decision	String	Case decision text (e.g., granted, denied, ordered removed)
appeal_decision	String	Appeal decision text
mtr_decision_string	String	Motion to Reopen/Reconsider decision text
reopen_decision	String	Reopen decision text
appeal_filed	Boolean	Whether an appeal has been filed
case_appeal_exists	Boolean	Whether a case appeal exists
pending_at_bia	Boolean	Whether the case is pending at the Board of Immigration Appeals
mtr_bia_appeal	Boolean	Whether a BIA-level MTR appeal exists
mtr_bia_type	String	Type of BIA-level MTR
reopen_exists	Boolean	Whether a motion to reopen exists

Appeal Details

Field	Type	Description
appeal_type	String	Type of appeal filed
appeal_filed_date	String	Date the appeal was filed
alien_brief_due	String	Deadline for the respondent's (alien's) brief
alien_brief_filed	String	Date the respondent's brief was filed
dhs_brief_due	String	Deadline for the DHS brief
dhs_brief_filed	String	Date the DHS brief was filed
bia_decision	String	Board of Immigration Appeals decision
bia_decision_date	String	Date of the BIA decision

Motion to Reopen / Reconsider (MTR)

Field	Type	Description
mtr_appeal_filed_date	String	Date the MTR appeal was filed
mtr_decision	String	MTR decision result
mtr_decision_date	String	Date of the MTR decision

Proceeding Details

Field	Type	Description
case_type	String	Case type code (e.g., RMV = Removal, DEP = Deportation)
base_city_code	String	Base city code of the immigration court
generation	String	Case generation number
subgeneration	String	Case subgeneration number
hearing_location_code	String	Code for the hearing location
hearing_location	String	Full hearing location address (pipe-separated)
ij_code	String	Immigration Judge code (from proceeding)
ij_name	String	Immigration Judge name (from proceeding)
decision_code	String	Decision code for the proceeding
comp_date	String	Completion date of the proceeding
date_appeal_due	String	Deadline date for filing an appeal
battered_spouse	Boolean	Whether the case involves VAWA battered spouse protections
release_info	String	Release information status (Y = Yes, N = No)
contact_address	String	Contact address for the proceeding

Reopen Details

Field	Type	Description
reopen_motion_received_date	String	Date the motion to reopen was received
reopen_comp_date	String	Completion date of the reopen proceeding
reopen_decision_detail	String	Detailed reopen decision

Schedule Details

Field	Type	Description
schedule_adj_date	String	Scheduled adjournment/hearing date (ISO format)
schedule_adj_time	String	Scheduled hearing time (e.g., 8:30 AM)
schedule_cal_type	String	Calendar type (M = Master, I = Individual)
schedule_type	String	Schedule type code (e.g., MR = Master)
schedule_hearing_medium	String	Hearing medium (P = In-Person, V = Video, T = Telephonic)
schedule_hearing_location_code	String	Hearing location code from the schedule
schedule_hearing_location	String	Full hearing location address from the schedule
schedule_contact_address	String	Court contact address and phone from the schedule
schedule_proceeding_id	Integer	Unique proceeding ID for this scheduled hearing

Judge Information

Field	Type	Description
judge_code	String	Immigration Judge code (from schedule)
judge_name	String	Immigration Judge full name (e.g., Olson, Christine)
judge_webex_url	String	Judge's WebEx URL for virtual hearings

Metadata

Field	Type	Description
cached	Boolean	Whether the result was served from cache
case_status	String	Case lookup result status (found or not_found)
api_time_taken_seconds	Number	API response time in seconds
scraped_at	String	ISO timestamp of when the data was extracted

---

Performance & Limits

• Response Time – EOIR lookups typically take 5–10 seconds per case (faster if cached).
• Retry Logic – Built-in 3 retries with exponential backoff (2s, 4s, 8s) for reliability.
• Timeout – 60-second timeout per request to handle slow EOIR responses.
• Caching – Results may be served from cache for faster response on repeated lookups.
• Single Lookup – Each run looks up one case at a time for accuracy and simplicity.

---

FAQ

• Q: What is an A-Number (Alien Registration Number)?
  • The A-Number is a 9-digit unique identifier assigned by USCIS to immigrants in the United States. It is used to track immigration cases across EOIR, USCIS, and ICE systems.
• Q: Where does the data come from?
  • Data is retrieved directly from the EOIR (Executive Office for Immigration Review) automated case information system.
• Q: What nationality format should I use?
  • Use the full country name in English (e.g., "Colombia", "Dominican Republic", "Mexico", "Guatemala", "El Salvador").
• Q: What does the clock status mean?
  • S = Case clock is Stopped (common during adjournments). R = Case clock is Running (active proceedings).
• Q: What are the calendar types (cal_type)?
  • M = Master Calendar Hearing (initial/scheduling hearing). I = Individual Merits Hearing (full trial on the merits).
• Q: What hearing mediums are available?
  • P = In-Person, V = Video Teleconference (VTC), T = Telephonic hearing.
• Q: What does case type RMV mean?
  • RMV = Removal proceedings. Other types include DEP (Deportation) and EXC (Exclusion).
• Q: What data formats can I export?
  • Apify supports exporting results as JSON, CSV, Excel (XLSX), XML, HTML, and RSS.

---

Troubleshooting

Issue	Cause	Solution
"No A-Number provided"	Empty or missing a_number input	Enter a valid 9-digit A-Number (numbers only, no dashes)
"No nationality provided"	Empty or missing nationality input	Enter the nationality / country of origin
"No case found for this A-Number"	A-Number doesn't exist in EOIR system or nationality mismatch	Verify the A-Number and nationality are correct and match
Slow response (> 10 seconds)	EOIR system processing delay	This is normal for uncached lookups. Retry if it times out
Network error	Internet connectivity issue or API temporarily down	Wait a few minutes and retry the run
Rate limit exceeded	Too many requests in a short period	Wait a few minutes before retrying

---

Why Choose This Actor?

• Instant immigration court case lookup by A-Number
• Real-time hearing dates, times, and court location
• Complete appeal and MTR (Motion to Reopen) tracking
• Judge assignment with WebEx hearing URLs
• Full proceeding history and case status flags
• Built-in retry logic for reliable data retrieval
• Downloadable as CSV, Excel, JSON, XML, or HTML

---

Tags

eoir scraper, immigration court case lookup, eoir case information, a-number lookup, immigration hearing date, eoir hearing schedule, immigration judge lookup, immigration court data, eoir api, immigration case tracker, bia appeal tracker, motion to reopen tracker, immigration data extraction, apify actor

---

Get Started Now

1. Enter the A-Number (9-digit Alien Registration Number)
2. Enter the Nationality (country of origin)
3. Click Start to run the lookup
4. View the case information in the dataset
5. Export your data in JSON, CSV, or Excel format
6. Click "Try for free" to test the actor

---

Built using Apify Platform | Optimized for Performance & Reliability