Ocrolus API

Ocrolus API Documentation

Welcome to Ocrolus' API Documentation. You'll find comprehensive guides and documentation here to help you get started with the Ocrolus API. Let's jump right in!

IRS Form 1099-K

IRS Form 1099-K "Payment Card and Third Party Network Transactions" is used to report payments received through payment card transactions and/or settlement of third-party payment network transactions.

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

Optional fields captured

πŸ“˜

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
a_1099_k-General:taxFormYearTextNumerical description of the Form's pre-printed year, e.g. "2019" for a 2019 form.
a_1099_k-General:filerNameTextName of the filer
a_1099_k-General:filerAddress:addressLine1TextAddress 1 of the filer
a_1099_k-General:filerAddress:addressLine2TextCity in which the filer is from
a_1099_k-General:filerAddress:cityTextFormatted 2 character state code
a_1099_k-General:filerAddress:stateText5 digit Zip code
a_1099_k-General:filerAddress:countryPayment Settlement Entity (PSE)
Electronic Payment Fecilitator (EPF)/Other Third Party
One of the values will be provided
a_1099_k-General:filerAddress:zipPayment card
Third party network
One of the values will be provided
a_1099_k-General:checkToIndicateIfFilerIsA(An)TextName of the payee
a_1099_k-General:checkToIndicateTransactionsReportedAreTextAdress of the payee
a_1099_k-General:payeeNameTextCity in which the payee is from
a_1099_k-General:streetAddress:addressLine1TextFormatted 2 character state code
a_1099_k-General:streetAddress:cityText5 digit Zip Code
a_1099_k-General:streetAddress:stateTextName of the PSE
a_1099_k-General:streetAddress:zipTextFormatted (XXX) XXX-XXXX. Phone number of the PSE
a_1099_k-General:pseNameTextAccount number
a_1099_k-General:pseTelephoneNumberCHECKED
NOT CHECKED
CHECKED if 2nd TIN provided
a_1099_k-General:accountNumberTextTIN of filer
a_1099_k-General:2ndTinNotTextTIN of the payee
a_1099_k-General:filerTinMoneyGross amount reported
a_1099_k-General:payeeTinMoneyAmount in card not present transactions
a_1099_k-Questions:line1A:grossAmountTextMerchant category of filer
a_1099_k-Questions:line1B:cardNotPresentTransactionTextNumber of payment transactions made
a_1099_k-Questions:line2:merchantCategoryCodeMoneyAmount of federal income tax withheld
a_1099_k-Questions:line3:numberOfPaymentTransactionsMoneyAmount reported for January
a_1099_k-Questions:line4:federalIncomeTaxWithheldMoneyAmount reported for February
a_1099_k-Questions:line5A:januaryMoneyAmount reported for March
a_1099_k-Questions:line5B:februaryMoneyAmount reported for April
a_1099_k-Questions:line5C:marchMoneyAmount reported for May
a_1099_k-Questions:line5D:aprilMoneyAmount reported for June
a_1099_k-Questions:line5E:mayMoneyAmount reported for July
a_1099_k-Questions:line5F:juneMoneyAmount reported for August
a_1099_k-Questions:line5G:julyMoneyAmount reported for September
a_1099_k-Questions:line5H:augustMoneyAmount reported for October
a_1099_k-Questions:line5I:septemberMoneyAmount reported for November
a_1099_k-Questions:line5J:octoberMoneyAmount reported for December
a_1099_k-Questions:line5K:novemberTextPrimary state of business
a_1099_k-Questions:line5L:decemberTextSecond state of business
a_1099_k-Questions:line6:stateLine1TextPrimary state ID
a_1099_k-Questions:line6:stateLine2TextSecondary state ID
a_1099_k-Questions:line7:stateIdentificationNoLine1MoneyState income tax reported for primary state
a_1099_k-Questions:line7:stateIdentificationNoLine2MoneyState income tax reported for secondary state

Sample Form

The below Ocrolus Sample PDF (input) matches the below Sample JSON Result (output).

Sample JSON Result

{
  "form_type": "A_1099_K",
  "pk": 4605478,
  "form_config_pk": 1485,
  "raw_fields": {
    "a_1099_k-General:2ndTinNot": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "UNCHECKED"
    },
    "a_1099_k-General:accountNumber": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "MID-493232526373584"
    },
    "a_1099_k-General:checkToIndicateIfFilerIsA(An)": {
      "alias_used": null,
      "is_empty": true,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": ""
    },
    "a_1099_k-General:checkToIndicateTransactionsReportedAre": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "PAYMENT CARD"
    },
    "a_1099_k-General:filerAddress:addressLine1": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "101 GREENWICH STREET"
    },
    "a_1099_k-General:filerAddress:addressLine2": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "FLOOR 23"
    },
    "a_1099_k-General:filerAddress:city": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "NEW YORK"
    },
    "a_1099_k-General:filerAddress:country": {
      "alias_used": null,
      "is_empty": true,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": ""
    },
    "a_1099_k-General:filerAddress:state": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "NY"
    },
    "a_1099_k-General:filerAddress:zip": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "10006"
    },
    "a_1099_k-General:filerName": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "OCROLUS INC."
    },
    "a_1099_k-General:filerTin": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "98-7654321"
    },
    "a_1099_k-General:payeeName": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "SAM BOBLEY"
    },
    "a_1099_k-General:payeeTin": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "12-3456789"
    },
    "a_1099_k-General:pseName": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "SAMPLE MERCHANT SERVICE"
    },
    "a_1099_k-General:pseTelephoneNumber": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "850-850-9090"
    },
    "a_1099_k-General:streetAddress:addressLine1": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "123 MAIN STREET"
    },
    "a_1099_k-General:streetAddress:city": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "NEW YORK"
    },
    "a_1099_k-General:streetAddress:state": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "NY"
    },
    "a_1099_k-General:streetAddress:zip": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "10001"
    },
    "a_1099_k-General:taxFormYear": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "2019"
    },
    "a_1099_k-Questions:line1A:grossAmount": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "74496246.00"
    },
    "a_1099_k-Questions:line1B:cardNotPresentTransaction": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "12555626.00"
    },
    "a_1099_k-Questions:line2:merchantCategoryCode": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "3605"
    },
    "a_1099_k-Questions:line3:numberOfPaymentTransactions": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "755"
    },
    "a_1099_k-Questions:line4:federalIncomeTaxWithheld": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "7565222.00"
    },
    "a_1099_k-Questions:line5A:january": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "3822588.00"
    },
    "a_1099_k-Questions:line5B:february": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "4585987.00"
    },
    "a_1099_k-Questions:line5C:march": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "5558989.00"
    },
    "a_1099_k-Questions:line5D:april": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "6225686.00"
    },
    "a_1099_k-Questions:line5E:may": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "7562589.00"
    },
    "a_1099_k-Questions:line5F:june": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "11255689.00"
    },
    "a_1099_k-Questions:line5G:july": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "9855898.00"
    },
    "a_1099_k-Questions:line5H:august": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "8544589.00"
    },
    "a_1099_k-Questions:line5I:september": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "4158898.00"
    },
    "a_1099_k-Questions:line5J:october": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "5889558.00"
    },
    "a_1099_k-Questions:line5K:november": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "4889879.00"
    },
    "a_1099_k-Questions:line5L:december": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "2145898.00"
    },
    "a_1099_k-Questions:line6:stateLine1": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "NY"
    },
    "a_1099_k-Questions:line6:stateLine2": {
      "alias_used": null,
      "is_empty": true,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": ""
    },
    "a_1099_k-Questions:line7:stateIdentificationNoLine1": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "133249958"
    },
    "a_1099_k-Questions:line7:stateIdentificationNoLine2": {
      "alias_used": null,
      "is_empty": true,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": ""
    },
    "a_1099_k-Questions:line8:stateIncomeTaxWithheldLine1": {
      "alias_used": null,
      "is_empty": false,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": "3598684.00"
    },
    "a_1099_k-Questions:line8:stateIncomeTaxWithheldLine2": {
      "alias_used": null,
      "is_empty": true,
      "page_doc_pk": 63625656,
      "source_filename": "2019 1099-k OCROLUS SAMPLE.pdf",
      "value": ""
    }
  },
  "tables": []
}

Updated about a year ago


IRS Form 1099-K


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.