Social Security Award Letter

Suggest Edits

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 attribute	Data type	Description
`ss_award_letter-General:year`	Integer	Year
`ss_award_letter-General:titleOfForm`	Text	Title Of Form
`ss_award_letter-General:awardType`	`SOCIAL SECURITY BENEFITS (SSA)SUPPLEMENTAL SECURITY INCOMEUNKNOWN`	Award Type
`ss_award_letter-General:beneficiaryName`	Text	Beneficiary Name
`ss_award_letter-General:address:addressLine1`	Text	Address Line 1
`ss_award_letter-General:address:addressLine2`	Text	Address Line 2
`ss_award_letter-General:address:city`	Text	City
`ss_award_letter-General:address:state`	Text	State
`ss_award_letter-General:address:zip`	Text	Zip
`ss_award_letter-General:awardDate`	Date	Award Date
`ss_award_letter-General:monthlyAmountBeforeDeductions`	Money	Monthly Amount Before Deductions
`ss_award_letter-General:paymentAmount`	Money	Payment Amount

Sample form

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

drive.google.com

SS Award Letter Samples - 1.pdf

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
}

Updated about 1 month ago