FDX REST API

/tax-forms POST

Attribute	Value
Summary	Create tax form
Description	Submit the data for a specific tax document
Operation Id	createTaxForm

Request Body

Media Type	Content	Description
application/json	TaxDataList	The full data contents of the tax document and all its included forms including the indexing metadata values

Response

Response Code	Response Type	Description
201	application/json of TaxDataList	Created document for the tax data submitted
206	application/json of TaxDataList	Partial Content success creating customer tax document, some errors are being returned

Example Request

POST /fdx/v4/tax-forms HTTP/1.1
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJjbGkiOiJ0YXhjbGkiLCJ1c2VyIjoiODEyMzQ1Njc4NSIsInBhc3MiOiJGWko1NTY0TkIzMCIsImlhdCI6MTYxMjg5ODM5MCwiZXhwIjoxNjEyOTAxOTkwfQ.weLW6ss1G0HD2Y9JeJ0OKVRCBHzARARrcawIRtoD-oo
Content-Type: application/json
User-Agent: Jersey/2.29 (HttpUrlConnection 1.8.0_252)
Host: api.taxdocserver.com
Connection: keep-alive
Content-Length: 955

[{"taxW2":{"taxYear":2020,"employeeTin":"XXX-XX-1234","employerTin":"12-3456789","employerNameAddress":{"line1":"12020 Sunrise Valley Dr","line2":"Suite 230","city":"Prescott","state":"VA","postalCode":"20191","name1":"FDR"},"controlNumber":"012547 WY/OA7","employeeName":{"first":"Kris","middle":"Q","last":"Public"},"employeeAddress":{"line1":"1 Main St","city":"Melrose","state":"NY","postalCode":"12121"},"wages":44416.74,"federalTaxWithheld":6907.16,"socialSecurityWages":47162.92,"socialSecurityTaxWithheld":2924.1,"medicareWages":47162.92,"medicareTaxWithheld":683.86,"codes":[{"code":"C","amount":301.5},{"code":"D","amount":2746.18},{"code":"DD","amount":4781.88}],"retirementPlan":true,"stateTaxWithholding":[{"stateTaxWithheld":1726.78,"state":"OH","stateTaxId":"OH 036-133505158F-01","stateIncome":44416.74}],"localTaxWithholding":[{"localTaxWithheld":427.62,"localityName":"Kirtland","state":"OH","localIncome":44416.74}]}}]

Example Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Cloud-Trace-Context: 3eab7986a3121becc83ef8bab2aa1dc4;o=1
Date: Tue, 09 Feb 2021 19:19:55 GMT
Server: Google Frontend
Content-Length: 1407
Connection: keep-alive

[ {
  "taxW2" : {
    "taxYear" : 2020,
    "taxFormId" : "283300001",
    "employeeTin" : "XXX-XX-1234",
    "employerTin" : "12-3456789",
    "employerNameAddress" : {
      "line1" : "12020 Sunrise Valley Dr",
      "line2" : "Suite 230",
      "city" : "Prescott",
      "state" : "VA",
      "postalCode" : "20191",
      "name1" : "Tax Doc Issuer"
    },
    "controlNumber" : "012547 WY/OA7",
    "employeeName" : {
      "first" : "Kris",
      "middle" : "Q",
      "last" : "Public"
    },
    "employeeAddress" : {
      "line1" : "1 Main St",
      "city" : "Melrose",
      "state" : "NY",
      "postalCode" : "12121"
    },
    "wages" : 44416.74,
    "federalTaxWithheld" : 6907.16,
    "socialSecurityWages" : 47162.92,
    "socialSecurityTaxWithheld" : 2924.1,
    "medicareWages" : 47162.92,
    "medicareTaxWithheld" : 683.86,
    "codes" : [ {
      "code" : "C",
      "amount" : 301.5
    }, {
      "code" : "D",
      "amount" : 2746.18
    }, {
      "code" : "DD",
      "amount" : 4781.88
    } ],
    "retirementPlan" : true,
    "stateTaxWithholding" : [ {
      "stateTaxWithheld" : 1726.78,
      "state" : "OH",
      "stateTaxId" : "OH 036-133505158F-01",
      "stateIncome" : 44416.74
    } ],
    "localTaxWithholding" : [ {
      "localTaxWithheld" : 427.62,
      "localityName" : "Kirtland",
      "state" : "OH",
      "localIncome" : 44416.74
    } ]
  }
} ]