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 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 INCOME
UNKNOWN

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).

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
}

Did this page help you?