RequestDraftPdfUrl

RequestDraftPdfUrl

This endpoint retrieves Draft PDF copies of a Form 1099 for a single recipient or multiple recipients. Request the Draft PDF URLs by providing the RecordId associated with the returns.

GET form1099/requestdraftpdfurl 

Run in Postman

Request Body

Field	Type	Description
RecordIds	Guid[]	A unique identifier generated by TaxBandits when a return is created. Mention the return's Record ID that you want to delete.

Response Body

Field	Type	Description
RecordId	Guid	A unique identifier of the record
EmployeeId	Guid	A unique identifier for each recipient set by you.
PayeeRef	string
DraftPdfUrl	string	URL of the Draft PDF
DraftPdfPath	string	Storage path of the draft PDF
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error code
Name	string	Name of the validation error
Message	string	Description of the validation error
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error code
Name	string	Name of the validation error
Message	string	Description of the validation error

Payload

Request Params

Sample	Description	Action
Sample 1	Query Params - Request Draft PDF URLs for generated Form 1099 returns using RecordId.

Sample 1

V2.0.0/FormACA/RequestDraftPdfUrl?RecordId=cf0a188b-6661-4b57-b04b-ba9ead52a16e

Response JSON

Response	Description	Action
200	Success Response - This is a sample response for successful API requests.

Response: 200

{
  "RecordId": "5ce0a501-ddcd-4b23-af7c-c836bc434bda",
  "EmployeeId": "ba15c63a-e191-4dbc-9156-457f0980052e",
  "EmployeeRef": null,
  "DraftPdfPath": "pdfs/c2d66a8c-3cf3-4dbc-9095-38b92fc58866/0927361d-25ec-47d5-9c37-7a239ec6a2fa/1099/19455581/d/copy_tbs_wm_1up_9455960000.pdf",
  "Error": null
}

Go Lang

  package main

  import (
      "fmt"
      "io"
      "net/http"
  )

  func main() {
      url := "<APIURL>/v2.0.0/form1099/requestdraftpdfurl?recordid=9e47bb81-4fe0-4ef9-878a-a136c5cd0033"
      method := "GET"

      // GET request does not require a request body
      req, err := http.NewRequest(method, url, nil)
      if err != nil {
          fmt.Println(err)
          return
      }

      req.Header.Add("Content-Type", "application/json")
      req.Header.Add("Authorization", "<ACCESS_TOKEN>")

      client := &http.Client{}

      res, err := client.Do(req)
      if err != nil {
          fmt.Println(err)
          return
      }
      defer res.Body.Close()

      body, err := io.ReadAll(res.Body)
      if err != nil {
          fmt.Println(err)
          return
      }

      fmt.Println(string(body))
  }

Node.js

  const axios = require('axios');
  let data = '';

  let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/form1099/requestdraftpdfurl?recordid=9e47bb81-4fe0-4ef9-878a-a136c5cd0033',
  headers: { 
      'Content-Type': 'application/json', 
      'Authorization': '<ACCESS_TOKEN>'
  },
  data : data
  };

  axios.request(config)
  .then((response) => {
  console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
  console.log(error);
  });

Python

  import http.client
  import json

  conn = http.client.HTTPSConnection("<APIURL>")
  payload = ''
  headers = {
  'Content-Type': 'application/json',
  'Authorization': '<ACCESS_TOKEN>'
  }
  conn.request("GET", "/v2.0.0/form1099/requestdraftpdfurl?recordid=9e47bb81-4fe0-4ef9-878a-a136c5cd0033", payload, headers)
  res = conn.getresponse()
  data = res.read()
  print(data.decode("utf-8"))

.NET C#

  var client = new HttpClient();
  var request = new HttpRequestMessage(HttpMethod.Get, "<APIURL>/v2.0.0/form1099/requestdraftpdfurl?recordid=9e47bb81-4fe0-4ef9-878a-a136c5cd0033");
  request.Headers.Add("Authorization", "<ACCESS_TOKEN>");
  var content = new StringContent("", null, "application/json");
  request.Content = content;
  var response = await client.SendAsync(request);
  response.EnsureSuccessStatusCode();
  Console.WriteLine(await response.Content.ReadAsStringAsync());

Ruby

  require "uri"
  require "json"
  require "net/http"

  url = URI("<APIURL>/v2.0.0/form1099/requestdraftpdfurl?recordid=9e47bb81-4fe0-4ef9-878a-a136c5cd0033")

  http = Net::HTTP.new(url.host, url.port);
  request = Net::HTTP::Get.new(url)
  request["Content-Type"] = "application/json"
  request["Authorization"] = "<ACCESS_TOKEN>"

  response = http.request(request)
  puts response.read_body

Java

  OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
  MediaType mediaType = MediaType.parse("application/json");
  RequestBody body = RequestBody.create(mediaType, "");
  Request request = new Request.Builder()
  .url("<APIURL>/v2.0.0/form1099/requestdraftpdfurl?recordid=9e47bb81-4fe0-4ef9-878a-a136c5cd0033")
  .method("GET", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "<ACCESS_TOKEN>")
  .build();
  Response response = client.newCall(request).execute();

cURL

  curl --location '<APIURL>/v2.0.0/form1099/requestdraftpdfurl?recordid=9e47bb81-4fe0-4ef9-878a-a136c5cd0033'   --header 'Content-Type: application/json'   --header 'Authorization: <ACCESS_TOKEN>'   --data ''