# Track your clients' USCIS cases through an API

> Read each client's cases, case status and notices from your USCIS online account by receipt number, with one API call each. A workflow can check the Action Required cases every morning and email you each new RFE, NOID or appointment notice.

Page: https://fous.com/automate/uscis-online-account
Updated: 2026-11-12

Works with your own USCIS online account account. Fous is an independent product.

## What you can build on the USCIS online account

### Get cases with action required

Reads the client list on the representative homepage with the Action Required filter on: the cases that have an RFE, a NOID or an appointment notice.

- Takes: Nothing
- Returns: Client, form number, receipt number, action, notice date

### Check a case's status and history

Opens the case card for one receipt number and reads its Case Status tab: the current status and each earlier step with its date.

- Takes: Receipt number
- Returns: Client, form number, receipt number, current status, status date, history

### List a case's notices

Reads the Documents or Notices tab of one case card: the receipt notices, RFEs and other notices USCIS has posted there.

- Takes: Receipt number
- Returns: Client, receipt number, notice name, notice date, response due date

### Upload a response to a Request for Evidence

Opens the RFE in a case card's Documents or Notices tab, uploads the evidence files you give and submits the response.

- Takes: Receipt number, evidence files (PDF, JPG or JPEG, up to 12 MB each)
- Returns: Receipt number, files uploaded, submitted at

## Automate the USCIS online account with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### New RFEs, NOIDs and appointment notices, every morning

Starts: Every weekday at 7:00

1. Get the cases shown under the Action Required filter.
2. Keep the cases that were not there on the last run.
3. Email you the list, with client, form number, receipt number and the kind of action.

### Case status changes, posted to your case management system

Starts: Every weekday at 8:00

1. For each receipt number you list, check the case status and history.
2. Keep the cases whose status changed since the last run.
3. Post client, form number, receipt number, new status and date to your webhook.

### Weekly notice summary for each open case

Starts: Every Monday at 9:00

1. For each receipt number you list, list the notices on the case card.
2. Keep the notices posted since the last run.
3. Group them by client with an AI step and email you the summary.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get cases with action required” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "my.uscis.gov/get_action_required_cases",
    "input": {}
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "cases": [
      {
        "client": "Acme Corp",
        "receipt_number": "IOE9999100231",
        "form_number": "I-129",
        "action": "Request for Evidence",
        "notice_date": "2026-11-06"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The USCIS online account’s own options

USCIS offers a Case Status API that returns the status of a case by receipt number. Production access comes after sandbox testing, a signed affidavit and a demo with USCIS, and demo appointments are fully booked through February 2027. Notices, RFE responses, G-28s and H-1B registrations are handled in the online account itself.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Case Status API | Case status information for one active receipt number per request, for customers and their representatives. | A developer account and OAuth 2.0 client credentials, 5 consecutive days of sandbox traffic, a wet-signed affidavit and a passed demo. |
| FOIA/PA Request and Status API | Submits a FOIA or Privacy Act request for A-File material and checks its status by request number. | A developer account and production access through the same developer portal. |
| The USCIS online account by hand | Filing, case status and history, notices, RFE responses, unsolicited evidence and secure messages, one case card at a time. | An account of your own for each person, never a shared one. Representatives use one account for all their clients. |

Read on November 12, 2026: [Case Status API](https://developer.uscis.gov/api/case-status), [Production access process](https://developer.uscis.gov/get-started/production-access), [Online filing for attorneys and accredited representatives](https://www.uscis.gov/file-online/online-filing-for-attorneys-and-accredited-representatives).

## Signing in to the USCIS online account

The USCIS online account asks for your email address and password, then a one-time verification code on every sign-in, sent by email, text message or both. With Fous you sign in once through the site's own sign-in with your own account: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

## Worth knowing

- **Only IOE paper cases link**: Paper-filed cases appear in a representative account only if their receipt number starts with IOE, and only when the G-28 carries your online account number, first name and last name exactly as in the account.
- **Representatives get no case alerts**: USCIS does not send case alerts to representatives. The Action Required filter is where cases with an RFE or NOID show up, so a method you build to read it can watch for them.
- **Your client signs before you submit**: In a guided filing your client opens the form with a one-time passcode, then signs Form G-28 and the form. A company client's administrator must accept your invitation before you can file for it.
- **Uploads: PDF, JPG or JPEG, 12 MB**: Evidence files must not be larger than 12 MB and are generally PDF, JPG or JPEG, with TIF or TIFF accepted for some forms. Files must not be encrypted or password-protected.

## More in Government: US federal

- [BSA E-Filing System](https://fous.com/automate/bsa-e-filing-system.md)
- [FINRA Gateway](https://fous.com/automate/finra-gateway.md)
- [PostalOne](https://fous.com/automate/postalone.md)
- [USPS Business Customer Gateway](https://fous.com/automate/usps-business-customer-gateway.md)
- [Invoice Processing Platform](https://fous.com/automate/invoice-processing-platform.md)
- [FMCSA Drug & Alcohol Clearinghouse](https://fous.com/automate/fmcsa-drug-and-alcohol-clearinghouse.md)
- [Wide Area Workflow](https://fous.com/automate/wide-area-workflow.md)
- [E-Verify](https://fous.com/automate/e-verify.md)
- [EPA Central Data Exchange](https://fous.com/automate/epa-central-data-exchange.md)
- [SAM.gov](https://fous.com/automate/sam-gov.md)
- [CM/ECF](https://fous.com/automate/cm-ecf.md)
- [EFTPS](https://fous.com/automate/eftps.md)
- [FBI NICS E-Check](https://fous.com/automate/fbi-nics-e-check.md)
- [FLAG](https://fous.com/automate/flag.md)
- [HUD Secure Systems](https://fous.com/automate/hud-secure-systems.md)
- [IRIS Taxpayer Portal](https://fous.com/automate/iris-taxpayer-portal.md)
- [Motus](https://fous.com/automate/motus.md)
- [TRACS / iMAX](https://fous.com/automate/tracs-imax.md)
- [USPTO Patent Center](https://fous.com/automate/uspto-patent-center.md)
- [EDGAR Filer Management](https://fous.com/automate/edgar-filer-management.md)
- [COD](https://fous.com/automate/cod.md)
- [IRS e-Services](https://fous.com/automate/irs-e-services.md)
- [IRS Tax Pro Account](https://fous.com/automate/irs-tax-pro-account.md)
- [EIV](https://fous.com/automate/eiv.md)
- [USPTO Trademark Center](https://fous.com/automate/uspto-trademark-center.md)
- [SSA Business Services Online](https://fous.com/automate/ssa-business-services-online.md)
- [NetDMR](https://fous.com/automate/netdmr.md)

Other industries: [Bonfire](/automate/bonfire), [myPATH](/automate/mypath), [Unemployment Services for Employers](/automate/unemployment-services-for-employers), [MSC Industrial Supply](/automate/msc-industrial-supply), [Workday VNDLY](/automate/workday-vndly), [Medline.com](/automate/medline-com).

## Frequently asked questions

### Does the USCIS online account have an API?

Not for the account itself. USCIS offers a Case Status API that returns a case's status by receipt number, and a FOIA request API, with production access after sandbox testing, a signed affidavit and a demo. Notices, RFE responses, G-28s and H-1B registrations stay in the online account.

### How do I find out when a client's case gets an RFE?

Turn on the Action Required filter in your representative account: it shows the cases with an RFE or NOID, because USCIS sends representatives no case alerts. With Fous, a workflow can read that filter every weekday and email you the cases that are new since the last run.

### Why don't all my paper-filed cases show in my account?

Only paper cases with an IOE receipt number can link to an online account. They link from the G-28, which must carry your online account number, first name and last name exactly as they appear in your account.

### Can I submit H-1B registrations from a representative account?

Yes. An attorney or accredited representative account can submit registrations for a prospective petitioner, which must also have its own organizational account. Each registration is for one beneficiary, and the fee for the FY 2027 cap is $215 per registration.

### Is Fous affiliated with US Citizenship and Immigration Services?

No. Fous is an independent product. You use it with your own USCIS online account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of USCIS online account (US Citizenship and Immigration Services). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.