# Get your FLAG case statuses through an API

> Read your FLAG cases by form and status, and the new actions in the Notification Center, with one API call each. Or have a workflow check every weekday morning and email you each new RFI and other case action.

Page: https://fous.com/automate/flag
Updated: 2026-11-12

Works with your own FLAG account. Fous is an independent product.

## What you can build on FLAG

### Get cases by form and status

Reads the Cases tab for one form type, such as 9089, and one category: Initiated, Pending Case Number, Assigned Case Number, Historical or Appeal.

- Takes: Form type, category, case status (optional), submitted since (optional)
- Returns: Case number, case status, employer name, foreign worker name, job title, case owner, submitted date

### List active notifications

Reads the Active list in the Notification Center: the new case actions FLAG marks with a red dot, such as an RFI.

- Takes: Nothing
- Returns: Case number, form type, notification type

### Get a case's final decision

Opens a case from the Historical category, reads Case Details and gets the final decision PDF from View PDF.

- Takes: Case number
- Returns: Case number, form type, case status, employer name, job title, determination date, final decision PDF

### Submit an RFI response

Opens a case with RFI Issued, chooses RFI Response in the Actions menu, uploads the documents with a description and submits.

- Takes: Case number, documents, document description
- Returns: Case number, action, confirmation message

## Automate FLAG 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 RFIs and other case actions, every weekday morning

Starts: Every weekday at 7:30

1. List the active notifications in the Notification Center.
2. Keep the notifications that were not there on the last run.
3. Email you the list, grouped by form type, with case number and notification type.

### Newly decided cases, posted to your case system

Starts: Every hour on weekdays

1. For each form type you file, get the cases in the Historical category.
2. Keep the cases that were not in Historical on the last run.
3. Post case number, form type, case status, employer name, foreign worker name and job title to your webhook.

### Weekly report of open PERM cases by status

Starts: Every Monday at 8:00

1. Get the 9089 cases in the Assigned Case Number category.
2. Group them by case status, such as Analyst Review, RFI Issued and Audit Review, and by case owner.
3. Email you the report with case number, employer name, foreign worker name, job title and submitted date.

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 by form and status” 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": "flag.dol.gov/get_cases",
    "input": {
      "form_type": "9089",
      "category": "Assigned Case Number"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "form_type": "9089",
    "category": "Assigned Case Number",
    "cases": [
      {
        "case_number": "G-100-26201-123456",
        "case_status": "Analyst Review",
        "employer_name": "Acme Robotics Inc.",
        "foreign_worker_name": "A. Example",
        "job_title": "Senior Controls Engineer",
        "case_owner": "Paralegal 2",
        "submitted_date": "2026-07-20"
      }
    ],
    "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.

## FLAG’s own options

The Department of Labor publishes no API for FLAG. You file and track cases in the FLAG web forms and tables, and FLAG emails you when a case gets an RFI. A Case Status Search takes up to 30 case numbers, and the Help Desk offers bulk upload for large H-2A networks.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Case Status Search | The status of up to 30 case numbers at a time, for CW-1, H-2A, H-2B, LCA, PERM and prevailing wage cases. | You enter up to 30 case numbers by hand. |
| Bulk upload through the Help Desk | H-2A profile entries: Crops or Commodities, Agricultural Businesses, Worker Housing and Material Terms of Employment. | A network with 50 or more entries for a single H-2A profile type. |
| FLAG by hand | Filing, the Cases tab by form and category, the Notification Center, case actions and final decision PDFs. | A FLAG account, signed in through Login.gov. |

Read on November 12, 2026: [FLAG Frequently Asked Questions](https://flag.dol.gov/support/FAQ), [FLAG Case Status Search](https://flag.dol.gov/case-status-search), [How to submit Form ETA-9089 in FLAG (user guide)](https://flag.dol.gov/sites/default/files/2024-08/PERM%20FLAG%20User%20guide.pdf).

## Signing in to FLAG

FLAG signs you in through Login.gov, which always asks for a second step: a face or fingerprint check on your device, an authentication app, a security key, a text or phone call, backup codes or a PIV/CAC card. With Fous you sign in through FLAG's own Login.gov sign-in with your own account, and the login is sealed with AES-256, never returned by the API and never seen by code or AI agents.

## Worth knowing

- **Your account decides which cases you see**: A master account sees every case in its network. A sub-account sees only the cases assigned to it, and an account can join one network at a time.
- **The Cases table refreshes about every 15 minutes**: A submitted case shows under Pending Case Number until it gets its case number. FLAG updates the Cases table with new case information about every 15 minutes.
- **Older PERM cases are checked elsewhere**: For PERM applications filed before 31 May 2023, FLAG's Case Status Search sends you to plc.doleta.gov.
- **Uploads have fixed types and a size limit**: RFI responses, audit responses and extension requests take PDF, DOC, DOCX, TXT or XLSX files of 30 MB or less. An audit response takes one document per action.

## 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)
- [HUD Secure Systems](https://fous.com/automate/hud-secure-systems.md)
- [USCIS online account](https://fous.com/automate/uscis-online-account.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: [AASHTOWare Project Civil Rights & Labor](/automate/aashtoware-project-civil-rights-and-labor), [myconneCT](/automate/myconnect), [The SOURCE](/automate/the-source), [SiePortal](/automate/sieportal), [Magnit VMS](/automate/magnit-vms), [NHS Supply Chain Online Catalogue](/automate/nhs-supply-chain-online-catalogue).

## Frequently asked questions

### Does FLAG have an API?

No. The Department of Labor publishes no API for FLAG. Cases are filed and tracked in the web forms and the Cases tab, the Case Status Search takes up to 30 case numbers at a time, and the Help Desk offers bulk upload of H-2A profile entries for networks with 50 or more of them.

### Where do I find a certified LCA or PERM decision in FLAG?

In the Historical category of the Cases tab. Open the case, go to Case Details and select View PDF for the final decision. Historical holds statuses such as Certified, Denied and Withdrawn.

### How long does an LCA take in FLAG?

The Department reviews an LCA within seven working days for completeness and obvious errors. An LCA may not be submitted more than 6 months before the period of employment begins.

### How do I know a case got an RFI or an audit?

FLAG emails the address entered on the application about an RFI and adds it to the Notification Center, and case actions show as red dots in the Cases table. A case selected for audit stays under Assigned Case Number and gets Audit Response, Request Extension and Withdraw in its Actions menu.

### Is Fous affiliated with the US Department of Labor?

No. Fous is an independent product. You use it with your own FLAG 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 FLAG (US Department of Labor, Office of Foreign Labor Certification). 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.