Get your FLAG case statuses through an API

What you can build on FLAG

• Get cases by form and status

  Build this

  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

  Build this

  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

  Build this

  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

  Build this

  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 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

  Build this

  Starts

  Every weekday at 7:30

  Step 1

  List the active notifications in the Notification Center.

  Step 2

  Keep the notifications that were not there on the last run.

  Step 3

  Email you the list, grouped by form type, with case number and notification type.

• Newly decided cases, posted to your case system

  Build this

  Starts

  Every hour on weekdays

  Step 1

  For each form type you file, get the cases in the Historical category.

  Step 2

  Keep the cases that were not in Historical on the last run.

  Step 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

  Build this

  Starts

  Every Monday at 8:00

  Step 1

  Get the 9089 cases in the Assigned Case Number category.

  Step 2

  Group them by case status, such as Analyst Review, RFI Issued and Audit Review, and by case owner.

  Step 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, 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.

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"
    }
  }'

{
  "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.

Read on November 12, 2026: FLAG Frequently Asked Questions, FLAG Case Status Search, How to submit Form ETA-9089 in FLAG (user guide).

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
• FINRA Gateway
• PostalOne
• USPS Business Customer Gateway
• Invoice Processing Platform
• FMCSA Drug & Alcohol Clearinghouse
• Wide Area Workflow
• E-Verify
• EPA Central Data Exchange
• SAM.gov
• CM/ECF
• EFTPS
• FBI NICS E-Check
• HUD Secure Systems
• USCIS online account
• IRIS Taxpayer Portal
• Motus
• TRACS / iMAX
• USPTO Patent Center
• EDGAR Filer Management
• COD
• IRS e-Services
• IRS Tax Pro Account
• EIV
• USPTO Trademark Center
• SSA Business Services Online
• NetDMR

Other industries: AASHTOWare Project Civil Rights & Labor, myconneCT, The SOURCE, SiePortal, Magnit VMS, NHS Supply Chain Online Catalogue.