USCIS JSON Reader: How to Find, Read & Analyze Case JSON
Learn how to extract, read, and interpret the raw JSON data behind your myUSCIS case status. Decode hidden timestamps, document lists, and internal service codes.
What Is myUSCIS Case JSON?
JSON (JavaScript Object Notation) is a text format used by modern web applications to transmit data between a database server and a browser client.
When you view your cases on my.uscis.gov, the web application doesn't load pre-made HTML. Instead, it queries a series of secure background endpoints. These endpoints return structured JSON files containing your raw case details. The browser then reads this JSON and renders it into the clean boxes and timelines you see on the dashboard.
Because the dashboard is designed to be simple for the average applicant, it hides most of the fields returned in the raw JSON response. By accessing the JSON directly, you can read these hidden details.
How to Manually Find Your Case JSON
If you are using a desktop or laptop computer, you can find the raw JSON using built-in developer tools. Follow these steps:
- Open Google Chrome, Microsoft Edge, or Firefox, and log into your account at my.uscis.gov.
- Right-click anywhere on the page and click Inspect (or press F12). This opens Developer Tools.
- Click on the Network tab at the top of the DevTools panel.
- Refresh the myUSCIS page. You will see a list of network requests loading in real-time.
- In the filter/search box, type
/api/cases/. - Click on the request that matches your receipt number (e.g.,
IOE0912345678). - Go to the Response or Preview tab. You will see a block of curly braces and keys. This is your raw case JSON.
Key JSON Fields Decoded
When you inspect the JSON data, you will see a list of key-value pairs. Here are the most significant keys that a USCIS JSON reader parses:
| JSON Key | Type | Description & Meaning |
|---|---|---|
receiptNumber | String | Your official case receipt number (e.g. starting with IOE). |
formType | String | The form classification (I-130, I-485, I-765, etc.). |
updatedAtTimestamp | Number | A Unix epoch timestamp marking the millisecond of the last database save. Critical for tracking silent updates. |
agencyActionRequired | Boolean | Indicates if USCIS is currently processing your file (false) or if you must take action like biometrics or RFE (true). |
cmsFailure | Boolean | Indicates if the Content Management System failed to sync (often explaining why public status is broken). |
documentList | Array | Contains detailed names and links for all PDF notices generated (e.g. approvals, RFEs) before they are sent via mail. |
Why You Need a Dedicated USCIS JSON Reader
While you can read raw JSON in text editors, it is very difficult to extract meaningful insights manually. Here is why using a dedicated analyzer like CaseStatusAPI makes a difference:
- Timestamp Translation: Converts Unix millisecond codes (e.g.
1781453042187) into standard human dates (e.g. June 14, 2026, 4:04 PM). - Snapshot History: Stores and compares previous JSON responses. If you check multiple times, it detects changes in properties like office location codes or document lists.
- AI Explanation: Feeds the raw attributes into our secure AI engine which cross-references community data, offering an explanation of what the current state means for your approval odds.
The CaseStatusAPI Chrome Extension (One-Click)
If opening browser inspection tools and copying text sounds too complicated, we built a free Chrome Extension to automate everything.
Once installed, you simply open the CaseStatusAPI home page. Our extension detects your active myUSCIS login session, fetches the JSON responses from all 4 primary endpoints behind the scenes, and loads them directly into our analyzer dashboard in a single click.
You get all the analytical depth of the USCIS case status API without ever seeing a line of raw code.
Frequently Asked Questions
What is a USCIS JSON reader?
It is an application that converts the raw structured JSON text response of the myUSCIS background API into a readable format with clear descriptions, dates, and alerts.
Where do I get my USCIS case JSON?
You can find it by logging into your myUSCIS portal, inspecting the page, and navigating to the Network tab to find the background API responses. Alternatively, CaseStatusAPI's Chrome Extension retrieves it automatically.
Why can't I read JSON on mobile easily?
Mobile browsers do not support Developer Tools (Network inspection) out of the box. CaseStatusAPI solves this by providing direct, authenticated links that load the API endpoint directly in your mobile browser tab, allowing you to copy the raw text easily.
Can I see PDF letters in the JSON?
Yes. The documentList array inside the cases response contains names and download paths of all notices generated by USCIS, often appearing prior to the status changing or physical mail delivery.
We are immigration applicants and technologists who built CaseStatusAPI to help others navigate the USCIS process with transparency. Our guides are informed by firsthand experience, community feedback, and deep analysis of USCIS internal API data.
Learn more about us →
Get Your AI-Powered Case Analysis
See internal USCIS data the regular tracker doesn't show — with a personalized AI breakdown of your case status, timeline, and next steps.
Starting at just $1.99$1.29 for an AI Analysis & Chat Pass.
Check Your Case Status →