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

ToolVersionResultDetail
pdfops APIhosted, tested 2026-11-09verified + deterministic flatten21/21 supported fields landed; flatten=true byte-deterministic (sha256 c05f5f8c4dfd…)
pdf-lib1.17.1fails at loadError: 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.5fails at loadError: Input document to `PDFDocument.load` is encrypted. You can use `PDFDocument.load(..., { ignoreEncryption: true })` if you wish to load the document anyways.
pypdf6.15.0text fields verified (15/15)15 text fields written and re-read (text fields only)
pdftk-java3.3.3verified (23/23)23 fields filled via FDF and re-dumped
qpdf --check11.9.0warningsWARNING: 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 checkno filled output to renderno filled PDF from the pdf-lib leg to render

File facts

Quirks & limitations

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 nameTypemaxLengthOptions
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]TextField4
form1[0].#subform[0].p1_Initial_FLD[0]TextField5
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).