# Pull your PostalOne postage statements into your systems

> Read postage statements from the PostalOne Dashboard, a job's qualification report and your Mailer Scorecard with one API call each. A workflow can hand each day's postage statements to accounting every evening.

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

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

## What you can build on PostalOne

### Find postage statements on the Dashboard

Searches the PostalOne Dashboard by Job ID, dates and Statement Status, including closed jobs, and opens each postage statement found.

- Takes: Date range, Job ID (optional), statement status (optional)
- Returns: Postage statement ID, job ID, statement status, PS Form, date of mailing, permit, pieces, total postage

### Read a job's qualification report

Finds a mailing job on the Dashboard by its Job ID and opens the Qualification Report linked from the job.

- Takes: Job ID
- Returns: Job ID, postage statement ID, report lines as shown

### Read the Mailer Scorecard for a month

Opens the Mailer Scorecard for a calendar month and reads each metric, with the drill-down of errors and warnings where a metric has them.

- Takes: Month, CRID (optional)
- Returns: Metric, pieces checked, errors, error rate, threshold, warnings

### Submit a postage statement in Postal Wizard

Fills in Postal Wizard from Mailing Services: PS Form, permit, date of mailing, mailing characteristics and piece counts, then submits after the certification statement.

- Takes: PS Form, permit, date of mailing, Mailer ID, Full-Service or not, piece counts per price line
- Returns: Confirmation, postage statement ID, total postage

## Automate PostalOne 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.

### Yesterday's postage statements, checked each morning

Starts: Every weekday at 7:00

1. Find the postage statements on the PostalOne Dashboard dated yesterday, closed jobs included.
2. Keep the statements whose status or total postage changed since the last run, and the new ones.
3. Email you the list with job ID, PS Form, pieces and total postage.

### Postage statements handed to accounting

Starts: Every weekday at 18:00

1. Find today's postage statements on the PostalOne Dashboard.
2. Keep the statements that were not there on the last run, and stop when there are none.
3. Post each one, with permit, date of mailing, pieces and total postage, to your accounting system's webhook.

### Mailer Scorecard changes during the month

Starts: Every weekday at 9:00

1. Read the Mailer Scorecard for the current month.
2. Keep the metrics whose errors or error rate changed since the last run.
3. Email you each one with its threshold and warnings.

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 “Find postage statements on the Dashboard” 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": "gateway.usps.com/find_postage_statements",
    "input": {
      "from": "2026-11-09",
      "to": "2026-11-11",
      "job_id": null
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "statements": [
      {
        "postage_statement_id": "PS-0048213",
        "job_id": "ACME1109",
        "statement_status": "Finalized",
        "ps_form": "3602-R",
        "date_of_mailing": "2026-11-10",
        "permit": "Permit Imprint 1234",
        "pieces": 18450,
        "total_postage": 6921.37,
        "currency": "USD"
      }
    ],
    "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.

## PostalOne’s own options

PostalOne takes electronic documentation three ways: Mail.dat files, Mail.XML web service messages and Postal Wizard. Mail.dat and Mail.XML come from mailing software built to USPS technical specifications, which USPS revises several times a year. Postal Wizard is entered by hand on the site, and postage statements and qualification reports are read on the Dashboard.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Mail.dat | A mailing database from your mailing software, uploaded with the Mail.dat Client to make the postage statement and qualification report. | A BCG account with a CRID, mailing software, and the Windows Mail.dat Client downloaded from Electronic Data Exchange (EDE). |
| Mail.XML | Mailing information sent to PostalOne as web service messages, by the Pull or Push method. | Mail.XML software you develop or buy on the USPS WSDLs and XSDs, and for Push a signed certificate from a Certification Authority. |
| PostalOne by hand | Postal Wizard for entering postage statements, the Dashboard for statements and qualification reports, and the Mailer Scorecard. | A BCG account. Postal Wizard needs an active mailing permit linked to it, and a Full-Service mailing there must be fewer than 50K pieces. |

Read on November 12, 2026: [Electronic Documentation (eDoc)](https://postalpro.usps.com/mailing/edoc), [How to Submit Mail.XML Jobs to PostalOne](https://postalpro.usps.com/mnt/glusterfs/2023-10/How%20to%20Submit%20Mail.XML%20Files%20to%20PostalOne.v4_10.25.2021.pdf), [Postal Wizard Fact Sheet](https://postalpro.usps.com/mnt/glusterfs/2024-08/Postal%20Wizard%20Fact%20Sheet.2024.08.20v2.pdf).

## Signing in to PostalOne

PostalOne is reached through the Business Customer Gateway, where you enter your username and password and select Sign In. The first user to register a business location becomes its Business Service Administrator, who decides who may use each service. With Fous you sign in once through the Gateway's own sign-in with your own account, and the login is sealed with AES-256.

## Worth knowing

- **Closed jobs are hidden by default**: To find a job's postage statement on the Dashboard, USPS's guides say to set Statement Status to ALL and check Include Closed Jobs before you search.
- **Scorecard numbers move until the 10th**: The Mailer Scorecard covers a calendar month and is updated daily. Verifications on a month's mailings continue until the 10th day of the following month.
- **Access is granted per business location**: Each business location has its own CRID. The Business Service Administrator of that location decides who can use a service there, so a method sees only what your account was granted.
- **Postal Wizard has limits**: In Postal Wizard a Full-Service mailing must be fewer than 50K pieces, and a mailing is either 100% or 0% Full-Service, never mixed. Intelligent Mail barcodes need separate software.

## 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)
- [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)
- [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: [BidNet Direct](/automate/bidnet-direct), [CDTFA Online Services](/automate/cdtfa-online-services), [Sunbiz](/automate/sunbiz), [Rexel France](/automate/rexel-france), [ShiftWise Flex](/automate/shiftwise-flex), [PCSE Online](/automate/pcse-online).

## Frequently asked questions

### Does PostalOne have an API?

For submitting mailings, yes: Mail.XML sends mailing information to PostalOne as web service messages built on USPS WSDLs and XSDs, and Mail.dat files go in through the Mail.dat Client. Both come from mailing software built to USPS technical specifications. The Dashboard and Mailer Scorecard are read on the site.

### How do I find the postage statement for a Mail.dat job?

Open the Dashboard from Mailing Services in the Business Customer Gateway and search by Job ID and dates, with Statement Status set to ALL and Include Closed Jobs checked. Select the Postage Statement ID to open the statement, and the Job ID to open the qualification report.

### When is a month's Mailer Scorecard final?

Not before the 10th day of the following month. Verifications on a month's mailings continue until then, so the figures can still change. The Scorecard is updated daily against the thresholds.

### Can I use Postal Wizard for every mailing?

No. In Postal Wizard a Full-Service mailing must be fewer than 50K pieces, and a mailing is either 100% or 0% Full-Service, never mixed. Mail.dat and Mail.XML, sent from mailing software, are the other two ways to submit eDoc.

### Is Fous affiliated with the United States Postal Service?

No. Fous is an independent product. You use it with your own Business Customer Gateway 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 PostalOne (United States Postal Service). 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.