Get your SFS Vendor Portal payments through an API

What you can build on the Vendor Portal

• Get payments

  Build this

  Reads the payments New York State agencies have made to your organization in the Vendor Portal.

  Takes

  Paid since (optional), agency (optional)

  Returns

  Payment ID, payment date, agency, payment method, amount

• Check eInvoice status

  Build this

  Reads your invoices in the Vendor Portal and the step of invoice processing each one has reached.

  Takes

  Invoice number (optional), invoice date from (optional)

  Returns

  Invoice number, invoice date, agency, PO number, amount, status, payment date

• Get purchase orders

  Build this

  Reads the purchase orders New York State agencies have issued to your organization in the Vendor Portal.

  Takes

  Issued since (optional), agency (optional)

  Returns

  PO number, PO date, agency, status, lines, amount

• Submit a self-service invoice

  Build this

  Creates a Self-service Invoice (SSI) in the Vendor Portal, attaches the supporting documents and submits it.

  Takes

  PO number, invoice number, invoice date, lines and amounts, supporting documents

  Returns

  Invoice number, PO number, amount, status

Automate the Vendor 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.

• New State payments, posted to your accounting system

  Build this

  Starts

  Every weekday at 7:00 (America/New_York)

  Step 1

  Get the payments made to your organization since yesterday.

  Step 2

  Keep the payments that were not there on the last run, and stop when there are none.

  Step 3

  Post each payment with its date, agency and amount to your accounting system's webhook.

• Weekly eInvoice status report

  Build this

  Starts

  Every Monday at 8:00 (America/New_York)

  Step 1

  Check the status of every invoice dated in the last 90 days.

  Step 2

  Keep the invoices not yet paid and those whose status changed since the last run.

  Step 3

  Email you the list, grouped by agency.

• New purchase orders to your order system

  Build this

  Starts

  Every weekday at 9:00 (America/New_York)

  Step 1

  Get the purchase orders issued to your organization in the last 7 days.

  Step 2

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

  Step 3

  Post each PO with its lines and amount to your order 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 “Get payments” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "esupplier.sfs.ny.gov/get_payments",
    "input": {
      "paid_since": "2026-11-01"
    }
  }'

{
  "status": "completed",
  "data": {
    "payments": [
      {
        "payment_id": "0004821937",
        "payment_date": "2026-11-06",
        "agency": "Northwind Agency",
        "payment_method": "ACH",
        "amount": 12480
      },
      {
        "payment_id": "0004833015",
        "payment_date": "2026-11-10",
        "agency": "Globex Agency",
        "payment_method": "ACH",
        "amount": 3275.5
      }
    ],
    "count": 2
  }
}

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

SFS describes no API for vendors. You can enter eInvoices yourself in the Vendor Portal as Self-service Invoices, or, for a high volume of invoices, set up XML Data Exchange or EDI with the SFS Help Desk. Payments, purchase orders, invoices and grant work are reviewed in the portal.

Read on November 12, 2026: eInvoicing Options Available for Vendors, SFS for vendors.

Signing in to the Vendor Portal

The Vendor Portal signs you in with a User ID and password. After several wrong passwords, or a long time without signing in, the account may be locked, and your organization's Delegated Admin resets the password and releases the account. With Fous you sign in once through the portal's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

Your Delegated Admin manages accounts

A locked vendor user, or a forgotten password, goes to the Delegated Admin of your organization, who can reset it. If you do not know who that is, ask your organization's Primary Contact.

Volume decides the invoicing route

SFS recommends Self-service Invoices for fewer than about 100 invoices a year, and XML Data Exchange or EDI above that, set up through the SFS Help Desk.

eInvoices and 15 Day Prompt Payment

Qualified small businesses that submit eInvoices may be eligible for 15 Day Prompt Payment. eInvoicing supports the Office of the State Comptroller's Proper Invoice Standards.

Grants live in the same portal

Grant opportunities, prequalification, contract approval, progress reports and claims are all handled in the Vendor Portal. Nonprofits must be prequalified to apply for grants.

More in Government: US state and local procurement

• PASSPort
• AASHTOWare Project Civil Rights & Labor
• BidNet Direct
• Bonfire
• OpenGov Procurement
• PlanetBids
• Cal eProcure
• COMMBUYS
• eVA
• MyFloridaMarketPlace Vendor Information Portal
• NC eProcurement

Other industries: Minnesota e-Services, NCSUITS, VWR (Avantor), Bullhorn, McKesson Connect, NIPR.