← Back to Home

How It Works

This tool provides a transparent bridge to your own USCIS case data using the same internal APIs that power the official myUSCIS website. Here is precisely how it functions and why it is safe.

Step-by-Step Guide

1. Log In to USCIS

You must be logged into your account at my.uscis.gov/account on this same browser. This establishes the secure session needed to fetch your data.

2. Enter Your Case Number

Enter your receipt number in the input field.
Important: Your case number must begin with "IOE" (Electronic System). Other prefixes like MSC or YSC are not currently supported by this internal API method.

3. Get Data & Copy JSON

Click the generated links (e.g., "Open Status Data"). A new tab will open with raw text (JSON). Select all text (Ctrl+A) and copy it (Ctrl+C).

Example JSON Response:
{
  "case_status": {
    "receiptNumber": "IOE1234567890",
    "formType": "I-130",
    "submittedDate": "2025-10-04",
    "applicantName": "Jane Doe",
    "currentStatus": "Case Was Received",
    "details": "Your case was received..."
  },
  "events": [
    { "date": "2025-10-04", "description": "Case Received" }
  ]
}

4. Paste & Analyze

Paste the text into the box in Step 3 and click "Analyze". The AI will interpret the codes and internal flags for you.

I-130 Petition Received and Acknowledged — IAF Event Confirmed.

Your I-130 Petition for Alien Relative (receipt IOE9841234567) was submitted on October 4, 2025. The case is currently open with no errors in the system, and all necessary data has been successfully synchronized. The only recorded event is the IAF (Intake Application Fee), confirming that your application fee has been accepted and the case has been officially documented in the system. The last internal system update occurred on November 29, 2025, indicating ongoing backend processing that does not yet reflect in public status changes.

Technical Insight:

  • receiptNumber: IOE9841234567 — 'IOE' prefix indicates the case was filed electronically through the USCIS Electronic Immigration System (ELIS).
  • formType: I-130 (Petition for Alien Relative) — This form facilitates the process for a U.S. citizen or lawful permanent resident to sponsor a relative for immigration.
  • ackedByAdjudicatorAndCms: true — Internal synchronization is confirmed between the adjudicating department and the Case Management System (CMS), indicating successful processing.
  • cmsFailure: false — There are no technical errors detected within the Case Management System; all operations relative to your case are functioning properly.
  • closed: false — Your case remains open and is being actively processed by USCIS.
  • isPremiumProcessed: false — Your application will follow the standard processing track, as premium processing was not selected.
  • actionRequired: false — USCIS does not require any further immediate action from you at this time.
  • nonElisPaperFiled: false — Indicates that this case was submitted electronically via ELIS rather than through paper filing.
  • elisChannelType: EFile — Confirms that the filing method used was electronic via the USCIS electronic portal.
  • noticeMailingPrefIndicator: false — No specific preference has been selected for how notices are to be mailed to you.
  • docMailingPrefIndicator: false — No specific preference set for document mailing.
  • areAllGroupStatusesComplete: false — Processing of all necessary stages/groups is not yet complete, which is typical for a case in progress.
  • areAllGroupMembersAuthorizedForTravel: true — All individuals involved in the case are currently authorized for travel.
  • concurrentCases: [] — There are no other cases opened concurrently related to this petition.
  • documents: [] — No documents generating or upload has been noted yet.
  • evidenceRequests: [] — No Requests for Evidence have been issued, which is a favorable sign.
  • notices: [] — There are currently no formal notices associated with your case.
  • addendums: [] — There are no addendums filed or attached to the case at this time.
  • Event 'IAF' (eventId: a0aa2dd6..., created 2025-10-04 at 15:52:08 UTC): Records that your intake application fee was successfully accepted, confirming that your filing has officially entered the system.

Case Timeline

2025-11-29
Internal System Activity — Backend processing detected (likely background checks or administrative review). No public status change.
Internal Update
2025-10-04
IAF Event (15:52 UTC) — Intake Application Fee / Filing confirmation recorded, initiating processing.
Event: IAF
2025-10-04
Case Submitted Electronically via ELIS.
Submitted

Your result should look like this

Is this legitimate?

  • Official Data Source: The data comes directly from my.uscis.gov servers. We do not invent or modify the data; we simply format the raw JSON response into a readable timeline.
  • Session-Based Security: This tool runs entirely in your browser alongside your active USCIS session. It does not ask for your password and cannot log you in. It relies on you being logged in already.
  • Zero Data Storage: We do not store your case data. The tool acts as a "viewer" for your own session.

Technical Explanation

The links generated by this tool (like `CaseStatus` and `CaseHistory`) point to internal API endpoints. These are the same endpoints the myUSCIS web application uses behind the scenes to render your dashboard.

These endpoints were discovered through standard browser inspection. They are unofficial, session-based interfaces not intended for public documentation, but they are fully accessible to you as the account owner.

Because they are session-based, they obey the same security rules as the main site. You must be logged in to my.uscis.gov in this browser for the request to succeed. This proves that only you can access this data.

In Summary: It’s technically just another way of viewing your own case data. It exposes the raw details (like "Internal System Activity") that the main dashboard might simplify or hide.
Disclaimer: This tool is an independent utility and is not affiliated with, endorsed by, or connected to U.S. Citizenship and Immigration Services (USCIS) or any government agency.