GuidesAPI ReferenceChangelog
Abound Dashboard

Create a Form 1099

Suggest Edits

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

Updated 23 days ago