Read your clients' APR Portal files through an API

What you can build on the APR Portal

• Check full application status

  Build this

  Searches a submitted application and reads its Application status and messages page: status, processing time, steps, documents and messages.

  Takes

  Application category, application number

  Returns

  Application number, UCI, date received, biometrics, current status, remaining processing time, processing steps, document statuses, messages

• Read Representative queue messages

  Build this

  Opens Account messages, searches the Representative queue by Category and Details, and reads each message listed.

  Takes

  Category (optional), details: Application/profile updated or Your action is required (optional)

  Returns

  Category, details, message subject, message text

• List applications not yet submitted

  Build this

  Reads the section Continue an application you have not submitted, where started applications wait until you submit them.

  Takes

  Nothing

  Returns

  Each application listed there, with the details the list shows

• Upload a document to a submitted application

  Build this

  Opens a submitted application's status page, follows the link to upload documents and attaches the file you give.

  Takes

  Application category, application number, document type, file

  Returns

  Application number, document type, document status

Automate the APR Portal 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.

• Your action is required, every morning

  Build this

  Starts

  Every weekday at 8:00 Eastern time

  Step 1

  Read the Representative queue messages with Details set to Your action is required.

  Step 2

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

  Step 3

  Email you the list with each message's category, subject and text.

• Weekly status changes for your open files

  Build this

  Starts

  Every Monday at 7:00 Eastern time

  Step 1

  For each application number in your list, check the full application status.

  Step 2

  Keep the files whose status, processing steps or document statuses changed since the last run.

  Step 3

  Post them to your case management system's webhook.

• Status on request from your case file

  Build this

  Starts

  When your system calls the workflow's webhook with an application category and number

  Step 1

  Check the full application status for that application.

  Step 2

  Post the status, processing steps, document statuses and messages back to your system's webhook.

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 “Check full application status” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "onlineservices-servicesenligne-cic.fjgc-gccf.gc.ca/check_application_status",
    "input": {
      "application_category": "Work permit",
      "application_number": "W300000000"
    }
  }'

{
  "status": "completed",
  "data": {
    "application_number": "W300000000",
    "uci": "00-0000-0000",
    "date_received": "2026-09-14",
    "biometrics": "Completed 2026-09-22",
    "current_status": "We are processing your client's application.",
    "remaining_processing_time": "54 days",
    "processing_steps": [
      "Review of eligibility: In progress",
      "Review of medical results: Not required"
    ],
    "document_statuses": [
      "Proof of employment with Acme Logistics: Received",
      "Letter of explanation: Requested"
    ],
    "messages": [
      "2026-10-02: Request for additional documents"
    ]
  }
}

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 APR Portal’s own options

IRCC's pages for representatives describe no API or file exchange for the APR Portal. You prepare, submit, link and pay for applications in the portal itself, check each file on its status page, and get an email when a new account message arrives. Most permanent residence applications and some others go through separate representative portals.

Read on November 12, 2026: Authorized Paid Representatives Portal, How to use the Authorized Paid Representatives Portal, Sign in to the APR Portal.

Signing in to the APR Portal

The APR Portal signs you in with the option you enrolled with: GCKey or a Sign-In Partner. With GCKey, every sign-in also asks for a 6-digit code from an authenticator app or sent to your email. With Fous you sign in once through the portal's own sign-in with your own account: the login is sealed with AES-256, an emailed code is handled, and an expired session is signed back in.

Worth knowing

New files can take 5 days to appear

IRCC says it can take up to 5 days for an application to show up in your account after it is received. A status check run sooner may find nothing.

Submitted files must be searched for

Once submitted, an application leaves the Continue an application list. If a search by application number finds nothing, IRCC suggests searching with the application category alone.

Linking needs an exact match

Add a client's application to your account links a file only when every detail matches the application form. When several match, you see the most recently submitted application.

More in Legal, courts and intellectual property

• Portal Informacyjny Sądów Powszechnych
• MyHMCTS
• eCourts e-Filing
• Money Claim Online
• PACER
• Arbitration Forums
• CCMS
• CounselLink
• Legal Tracker
• TyMetrix 360
• Collaborati
• MyEPO Portfolio

Other industries: CARM Client Portal, Schwab Advisor Center, INTTRA, RMIS, IMDS, Online Coordination System.