Create a Form 1099

The following is an example of creating a Form 1099. Note that all form types follow the same pattern for creation, but for more information on a specific form type, please read the full reference:

Generating a Form 1099

To create a Form 1099 directly from our API you'll need information about the Payee, information about the Payer, and specific form fields values for your that form type.

📘
tin or tinFingerprint ?
For both the Payer and Payee we allow you to pass either the plain text tin or a previously created tinFingerprint.

curl \
  -request POST \
  -url https://sandbox-api.withabound.com/v4/documents/1099-K \
  -header 'accept: application/json' \
  -header 'content-type: application/json' \
  --data '{
  "filingYear": 2023,
  "payer": {
    "name": "Hooli",
    "tin": "111111111",
    "address": "1401 N Shoreline Blvd",
    "address2": "Suite 1",
    "city": "Mountain View",
    "state": "CA",
    "postalCode": "94043",
    "country": "US",
    "phoneNumber": "6501014096"
  },
  "payee": {
    "name": "Ada Lovelace",
    "tin": 000000000",
    "address": "256 Byron Street",
    "address2": "Suite 32",
    "city": "Palo Alto",
    "state": "CA",
    "postalCode": "94306",
    "country": "US"
  },
  "formFields": {
    ...
  }
}'

Response

The response will contain all the information from the request, plus the following addition information:

a unique documentId
the createdAt timestamp
thepayerUrl that links to the generated pdf of the Payer's copy of the form
the payeeUrl that links to the generated pdf of the Payee's copy of the form
the status of the form

{
  "id": "documentId_sampletTtqNfulW8",
  "createdAt": "2023-01-01T00:00:00.000Z",
  "status": "CREATED",
  "payerUrl": "https://tax-documents-sandbox.s3.us-west-2.amazonaws.com/documents/FORM-1099-COPY-C.pdf",
  "payeeUrl": "https://tax-documents-sandbox.s3.us-west-2.amazonaws.com/documents/FORM-1099-COPY-B.pdf",
  "filingYear": 2022,
  "payer": {
    "name": "Hooli",
    "tin": "*******11",
    "address": "1401 N Shoreline Blvd",
    "address2": "Suite 1",
    "city": "Mountain View",
    "state": "CA",
    "postalCode": "94043",
    "country": "US",
    "phoneNumber": "6501014096",
    "tinType": "BUSINESS",
    "tinFingerprint": "tinFingerprint_sample847jI1LwxF",
    "tinVerificationId": "tinVerificationId_sample1b0E6efa89",
    "tinVerificationStatus": "MATCH",
  },
  "payee": {
    "name": "Ada Lovelace",
    "tin": "*******00",
    "address": "256 Byron Street",
    "address2": "Suite 32",
    "city": "Palo Alto",
    "state": "CA",
    "postalCode": "94306",
    "country": "US",
    "tinType": "INDIVIDUAL",
    "tinFingerprint": "tinFingerprint_samplehy2BWO6JJG",
    "tinVerificationId": "tinVerificationId_sample41SD71AV8f",
    "tinVerificationStatus": "MATCH",
  },
  "formFields": {
    ...
  }
}

📘
Automatic Tin Verification
It's important to note that if the combination of the Payee's or Payer's name and tin has not been seen before on the Abound platform, a Tin Verification will automatically be created. In the event that a new Tin Verification was created, a tinVerificationId will be returned in the response nested in the payee and/or the payer object(s).