File Tax Document - Treasury Prime Developer Documentation

File Tax Document

curl --request PATCH \
  --url https://api.treasuryprime.com/account/{account_id}/tax_document/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "taxdoc_abc456",
  "status": "filed"
}
'

import requests

url = "https://api.treasuryprime.com/account/{account_id}/tax_document/{id}"

payload = {
    "id": "taxdoc_abc456",
    "status": "filed"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({id: 'taxdoc_abc456', status: 'filed'})
};

fetch('https://api.treasuryprime.com/account/{account_id}/tax_document/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.treasuryprime.com/account/{account_id}/tax_document/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 'taxdoc_abc456',
    'status' => 'filed'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.treasuryprime.com/account/{account_id}/tax_document/{id}"

	payload := strings.NewReader("{\n  \"id\": \"taxdoc_abc456\",\n  \"status\": \"filed\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

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

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.treasuryprime.com/account/{account_id}/tax_document/{id}")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": \"taxdoc_abc456\",\n  \"status\": \"filed\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.treasuryprime.com/account/{account_id}/tax_document/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": \"taxdoc_abc456\",\n  \"status\": \"filed\"\n}"

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

{
  "account_id": "acct_2074732992",
  "is_correction": false,
  "status": "pending",
  "type": "1099",
  "year": "2024"
}

PATCH

/

account

/

{account_id}

/

tax_document

/

{id}

File Tax Document

curl --request PATCH \
  --url https://api.treasuryprime.com/account/{account_id}/tax_document/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "taxdoc_abc456",
  "status": "filed"
}
'

import requests

url = "https://api.treasuryprime.com/account/{account_id}/tax_document/{id}"

payload = {
    "id": "taxdoc_abc456",
    "status": "filed"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({id: 'taxdoc_abc456', status: 'filed'})
};

fetch('https://api.treasuryprime.com/account/{account_id}/tax_document/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.treasuryprime.com/account/{account_id}/tax_document/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 'taxdoc_abc456',
    'status' => 'filed'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.treasuryprime.com/account/{account_id}/tax_document/{id}"

	payload := strings.NewReader("{\n  \"id\": \"taxdoc_abc456\",\n  \"status\": \"filed\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

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

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.treasuryprime.com/account/{account_id}/tax_document/{id}")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": \"taxdoc_abc456\",\n  \"status\": \"filed\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.treasuryprime.com/account/{account_id}/tax_document/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": \"taxdoc_abc456\",\n  \"status\": \"filed\"\n}"

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

{
  "account_id": "acct_2074732992",
  "is_correction": false,
  "status": "pending",
  "type": "1099",
  "year": "2024"
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

account_id

string

required

Account ID

id

string

required

Tax Document ID

Body

application/json

The account.tax_document.update to update

account_id

string

Account ID

skip_tin_verification

enum<string>

Boolean indicating whether TIN verification should be skipped when filing the tax document. When tax filing is triggered, TIN verification is run before the document is sent to the agency for filing. TIN verification checks that the TIN and name of the payee on tax document match to avoid failures after sending to the IRS. TIN verification typically takes 24 hours. When this flag is true, TIN verification is skipped and filing of the tax document is immediately triggered.

Available options:

true,

false

status

string

Status of the tax document

Response

200 - application/json

The account.tax_document.update updated

The response is of type object.