Forms / IRS
Fill Form 8822-B programmatically
Form 8822-B — Change of Address or Responsible Party — Business. Official IRS PDF, 2 pages, 22 fields read automatically.
Registered-agent and compliance platforms produce 8822-Bs constantly: every client that moves owes the IRS one, and a responsible-party change is supposed to be reported within 60 days of happening. It is a two-page form with a handful of lines — exactly the kind of document that gets deferred when a person has to make it, and trivial when a system does.
What you send
Real field names, straight from the PDF — the excerpt shows the first 5 of 22. The full list is in the table below, and the template hands you the complete JSON schema to copy.
{
"data": {
"topmostSubform[0].Page1[0].c1_1[0]": true,
"topmostSubform[0].Page1[0].c1_2[0]": true,
"topmostSubform[0].Page1[0].c1_3[0]": true,
"topmostSubform[0].Page1[0].c1_4[0]": true,
"topmostSubform[0].Page1[0].Line4aReadOrder[0].f1_1[0]": "string"
}
}
// …plus 17 more fields, all listed belowWhat you get back
The completed Form 8822-B, streamed back as the response — or delivered to your webhook, HMAC-signed.
curl -X POST https://www.doc2api.co/api/v1/templates/<ID>/fill \ -H "X-Api-Key: d2a_live_…" \ -H "Content-Type: application/json" \ -d @payload.json -o filled.pdf # → the completed Form 8822-B as a PDF. # With a webhook configured, the reply is JSON and the # document arrives at your endpoint as a signed URL.
Or skip the mapping entirely: embed the actual form on your site and let the person it belongs to fill and sign it — you receive the values as JSON and the finished PDF.
Every field on Form 8822-B
Extracted automatically from the official PDF — this table is generated by the same code that reads your uploads. In the editor, each of these is highlighted on the page itself, so you never map a name blind.
| Field name | Type | Notes |
|---|---|---|
| topmostSubform[0].Page1[0].c1_1[0] | checkbox | |
| topmostSubform[0].Page1[0].c1_2[0] | checkbox | |
| topmostSubform[0].Page1[0].c1_3[0] | checkbox | |
| topmostSubform[0].Page1[0].c1_4[0] | checkbox | |
| topmostSubform[0].Page1[0].Line4aReadOrder[0].f1_1[0] | text | |
| topmostSubform[0].Page1[0].Line4bReadOrder[0].f1_2[0] | text | max 10 chars |
| topmostSubform[0].Page1[0].f1_3[0] | text | |
| topmostSubform[0].Page1[0].f1_4[0] | text | |
| topmostSubform[0].Page1[0].f1_5[0] | text | |
| topmostSubform[0].Page1[0].f1_6[0] | text | |
| topmostSubform[0].Page1[0].f1_7[0] | text | |
| topmostSubform[0].Page1[0].f1_8[0] | text | |
| topmostSubform[0].Page1[0].f1_9[0] | text | |
| topmostSubform[0].Page1[0].f1_10[0] | text | |
| topmostSubform[0].Page1[0].f1_11[0] | text | |
| topmostSubform[0].Page1[0].f1_12[0] | text | |
| topmostSubform[0].Page1[0].f1_13[0] | text | |
| topmostSubform[0].Page1[0].f1_14[0] | text | |
| topmostSubform[0].Page1[0].f1_15[0] | text | |
| topmostSubform[0].Page1[0].f1_16[0] | text | max 11 chars |
| topmostSubform[0].Page1[0].f1_17[0] | text | |
| topmostSubform[0].Page1[0].f1_18[0] | text |
Small form, big batch
At 22 fields this is the smallest form in the gallery, which makes it the best fit for the batch endpoint: one array or CSV — old address, new address, entity, signer — returns one completed form per client, ready for signatures. An office move that touches two hundred clients is one request.
Questions people ask
- When is an 8822-B required?
- Per the form's instructions: when a business changes its mailing address, its location, or its responsible party — the last within 60 days of the change. Deadlines and applicability are the filer's to confirm; we produce the document.
- Can each client sign their own?
- Yes — generate the batch, then send each client their form's embed link to sign; every signed copy is delivered to your webhook with the client's ID attached as params.
See your Form 8822-B pipeline working in the next five minutes
The button uploads the official PDF into the editor as a live template with an API key — no account, nothing to cancel. Trial documents are watermarked and kept for 24 hours; sign up to keep your work.
Doc2api is not affiliated with the Internal Revenue Service. Form 8822-B is a public government work; the copy here is the official revision, refreshed from irs.gov. Nothing on this page is tax or legal advice — how a completed form may be signed, filed or retained is defined by the issuing agency.