Registry
Form SSA-89 — programmatic fill compatibility
Authorization for the Social Security Administration to Release Social Security Number Verification · Social Security Administration (SSA) · 05-2025. Tested 2026-11-09 on the unmodified upstream blank — every number below comes from a recorded run, not from documentation.
Verdict at a glance
| Tool | Version | Result | Detail |
|---|---|---|---|
| pdfops API | hosted, tested 2026-11-09 | verified + deterministic flatten | 21/21 supported fields landed; flatten=true byte-deterministic (sha256 c05f5f8c4dfd…) |
| pdf-lib | 1.17.1 | fails at load | Error: Input document to `PDFDocument.load` is encrypted. You can use `PDFDocument.load(..., { ignoreEncryption: true })` if you wish to load the document anyways. |
| @cantoo/pdf-lib (fork) | 2.6.5 | fails at load | Error: Input document to `PDFDocument.load` is encrypted. You can use `PDFDocument.load(..., { ignoreEncryption: true })` if you wish to load the document anyways. |
| pypdf | 6.15.0 | text fields verified (15/15) | 15 text fields written and re-read (text fields only) |
| pdftk-java | 3.3.3 | verified (23/23) | 23 fields filled via FDF and re-dumped |
| qpdf --check | 11.9.0 | warnings | WARNING: public/registry/blank/ssa-89.pdf: page 0: shared object 209: in hint table but not computed list | qpdf: operation succeeded with warnings |
| poppler render check | no filled output to render | no filled PDF from the pdf-lib leg to render |
File facts
- Source: https://www.ssa.gov/forms/ssa-89.pdf (issuer page: here)
- Blank tested: ssa-89.pdf · 51 KB · sha256
c47e19193c0d1f4897f82f4ac07d866e3e818f478a31ad8070156dfcefc49f7a - License: US federal government work — public domain (17 U.S.C. § 105). The hash-verified blank is redistributed here unmodified.
- Structure: ? pages · no AcroForm · encrypted
- Fields: 23 (15 text, 8 checkbox)
Quirks & limitations
- Signed by borrowers in nearly every US mortgage closing (SSN verification consent under the CBSV program), so document-prep systems fill it constantly.
- ssa.gov refuses plain curl/script fetches of this file; the blank here was retrieved through a real browser session. Automate the FILL, and fetch the blank once by hand or through a browser lane.
Tested request
This exact shape ran against the live API during the recorded test (values here shortened to two fields; the test filled all 21 supported fields). With flatten=true, two identical runs produced byte-identical output — sha256 c05f5f8c4dfd0651a8f2cd14db0824e34733060a9ad1e26cbc48f4e1d88bbed7.
curl -X POST https://pdfops.dev/api/fill-form \
-F "pdf=@ssa-89.pdf" \
-F 'fields={"form1[0].#subform[0].p1_PrintedName_FLD[0]":"Jane Doe","form1[0].#subform[0].p1_DOB_FLD[0]":"Jane Doe"}' \
-F "flatten=true" \
-o filled.pdf
Enumerate all 23 field names first with the inspector or POST /api/inspect.
Field schema
All 23 fields (name, type, maxLength, options)
| Field name | Type | maxLength | Options |
|---|---|---|---|
form1[0].#subform[0].p1_PrintedName_FLD[0] | TextField | ||
form1[0].#subform[0].p1_DOB_FLD[0] | TextField | ||
form1[0].#subform[0].P1_SSN_FLD[0] | TextField | ||
form1[0].#subform[0].P1_Mortgage_CB[0] | CheckBox | ||
form1[0].#subform[0].P1_Bankacct_CB[0] | CheckBox | ||
form1[0].#subform[0].P1_CreditCard_CB[0] | CheckBox | ||
form1[0].#subform[0].p1_Loan_CB[0] | CheckBox | ||
form1[0].#subform[0].p1_Retirement_CB[0] | CheckBox | ||
form1[0].#subform[0].P1_applyforajob_CB[0] | CheckBox | ||
form1[0].#subform[0].P1_licensingrequriement_CB[0] | CheckBox | ||
form1[0].#subform[0].P1_Other_CB[0] | CheckBox | ||
form1[0].#subform[0].P1_OtherText_FLD[0] | TextField | ||
form1[0].#subform[0].P1_CompanyName_FLD[0] | TextField | ||
form1[0].#subform[0].p1_CompanyAddress_FLD[0] | TextField | ||
form1[0].#subform[0].P1_AgentsName_FLD[0] | TextField | ||
form1[0].#subform[0].P1_AgentAddress_FLD[0] | TextField | ||
form1[0].#subform[0].p1_ValidFor_FLD[0] | TextField | 4 | |
form1[0].#subform[0].p1_Initial_FLD[0] | TextField | 5 | |
form1[0].#subform[0].p1_Signature_FLD[0] | TextField | ||
form1[0].#subform[0].p1_DateSigned_FLD[0] | TextField | ||
form1[0].#subform[0].p1_Relationship_FLD[0] | TextField | ||
form1[0].#subform[0].P1_PAReadonly_FLD[0] | TextField | ||
form1[0].#subform[0].P1_PRAReadOnly_FLD[0] | TextField |
Frequently asked
Can I fill the Form SSA-89 programmatically?
Yes — the blank 05-2025 Form SSA-89 is a fillable AcroForm with 23 fields. In our tested run, all 21 supported fields were filled through the pdfops API and verified by re-inspecting the output; upstream pdf-lib cannot open it, and pypdf handled its text fields. Field names are listed in the schema on this page.
Why do PDF libraries reject the Form SSA-89?
The blank is AES-encrypted with an empty user password: anyone can open it in a viewer, but the owner password restricts modification, and strict parsers refuse the file outright. The pdfops API opens owner-locked files like this directly, and a password form field covers files that need a user password. qpdf --decrypt removes the restriction losslessly; pypdf can open it directly when its optional cryptography dependency is installed; pdftk-java both reads and fills it natively (its output is decrypted).
← All forms in the registry · Inspect your own PDF · Make a flat PDF fillable