Social Security Award Letter

A Social Security award letter (also known as an award notice) is what the Social Security Administration sends out to inform an individual that a claim for benefits has been approved. Though award letters go out for any type of benefit application, the term is most commonly associated with disability claims.

The form_type parameter SS_AWARD_LETTER for the Upload PDF endpoint is required for this Form Type.

Optional invoice/receipt header & footer data captured

Field data attributed directly to a Social Security award letter is captured as form data objects, each one keyed off the following attribute names.

📘

Configuration-driven output

All fields below are optionally captured, depending on your order form. To adjust fields captured, please speak with your Ocrolus Account Manager.

JSON attributeData typeDescription
ss_award_letter-General:yearIntegerYear
ss_award_letter-General:titleOfFormTextTitle Of Form
ss_award_letter-General:awardTypeSOCIAL SECURITY BENEFITS (SSA)SUPPLEMENTAL SECURITY INCOMEUNKNOWNAward Type
ss_award_letter-General:beneficiaryNameTextBeneficiary Name
ss_award_letter-General:address:addressLine1TextAddress Line 1
ss_award_letter-General:address:addressLine2TextAddress Line 2
ss_award_letter-General:address:cityTextCity
ss_award_letter-General:address:stateTextState
ss_award_letter-General:address:zipTextZip
ss_award_letter-General:awardDateDateAward Date
ss_award_letter-General:monthlyAmountBeforeDeductionsMoneyMonthly Amount Before Deductions
ss_award_letter-General:paymentAmountMoneyPayment Amount

Sample form

The below Ocrolus sample PDF (input) matches the below sample JSON result (output).

Sample JSON result

{
  "pk": 16048066,
  "uuid": "0865c976-d239-42d9-aa74-09692c5dfeca",
  "name": "SS Award Letter Output 2",
  "created": "2022-01-12T22:51:41Z",
  "created_ts": "2022-01-12T22:51:41Z",
  "verified_pages_count": 1,
  "book_status": "ACTIVE",
  "id": 16048066,
  "forms": [
    {
      "pk": 33693976,
      "uuid": "2108f5f9-37bf-4e28-9d1c-621e664e3374",
      "form_type": "SS_AWARD_LETTER",
      "raw_fields": {
        "ss_award_letter-General:year": {
          "value": "2014",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:awardDate": {
          "value": "11/01/2014",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:awardType": {
          "value": "SOCIAL SECURITY BENEFITS (SSA)",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:address:zip": {
          "value": "91301",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:address:city": {
          "value": "AGOURA HILLS",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:address:state": {
          "value": "CA",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:paymentAmount": {
          "value": "485.00",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:beneficiaryName": {
          "value": "STEPHEN GROSSBERG",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:address:addressLine1": {
          "value": "30141 AGOURA RD",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:address:addressLine2": {
          "value": "STE 212",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        },
        "ss_award_letter-General:monthlyAmountBeforeDeductions": {
          "value": "500.60",
          "is_empty": false,
          "alias_used": null,
          "source_filename": "SS Award Letter Samples - 1.pdf"
        }
      },
      "form_config_pk": 12475,
      "tables": []
    }
  ],
  "book_is_complete": true
}