Skip to main content
POST
/
providers
/
irs
/
f8821
/
unsigned
cURL
curl --request POST \
  --url https://api.trychart.com/providers/irs/f8821/unsigned \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "personalInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "ssn": "123456789"
  },
  "address": {
    "street": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94101",
    "other": "Apt 1"
  },
  "form56": {
    "authority": {
      "1gDesc": "<string>",
      "2a": "<string>",
      "2b": "<string>"
    },
    "tax": {
      "5": "<string>",
      "types": [],
      "typeDesc": "<string>",
      "forms": [],
      "formDesc": "<string>"
    },
    "proceedings": {
      "name": "<string>",
      "address": {
        "street": "<string>",
        "other": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "date": "<string>",
      "time": {
        "text": "<string>"
      },
      "initiationDate": "<string>",
      "docketNumber": "<string>",
      "placeOfOtherProceedings": "<string>"
    },
    "title": "<string>"
  },
  "extraDesignees": [
    {
      "name": "<string>",
      "address": {
        "street": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94101",
        "other": "Apt 1"
      },
      "cafNumber": "<string>",
      "monitorIRSNotices": true
    }
  ]
}
'
import requests

url = "https://api.trychart.com/providers/irs/f8821/unsigned"

payload = {
    "personalInfo": {
        "firstName": "John",
        "lastName": "Doe",
        "ssn": "123456789"
    },
    "address": {
        "street": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94101",
        "other": "Apt 1"
    },
    "form56": {
        "authority": {
            "1gDesc": "<string>",
            "2a": "<string>",
            "2b": "<string>"
        },
        "tax": {
            "5": "<string>",
            "types": [],
            "typeDesc": "<string>",
            "forms": [],
            "formDesc": "<string>"
        },
        "proceedings": {
            "name": "<string>",
            "address": {
                "street": "<string>",
                "other": "<string>",
                "city": "<string>",
                "state": "<string>",
                "zip": "<string>"
            },
            "date": "<string>",
            "time": { "text": "<string>" },
            "initiationDate": "<string>",
            "docketNumber": "<string>",
            "placeOfOtherProceedings": "<string>"
        },
        "title": "<string>"
    },
    "extraDesignees": [
        {
            "name": "<string>",
            "address": {
                "street": "123 Main St",
                "city": "San Francisco",
                "state": "CA",
                "zip": "94101",
                "other": "Apt 1"
            },
            "cafNumber": "<string>",
            "monitorIRSNotices": True
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    personalInfo: {firstName: 'John', lastName: 'Doe', ssn: '123456789'},
    address: {
      street: '123 Main St',
      city: 'San Francisco',
      state: 'CA',
      zip: '94101',
      other: 'Apt 1'
    },
    form56: {
      authority: {'1gDesc': '<string>', '2a': '<string>', '2b': '<string>'},
      tax: {
        '5': '<string>',
        types: [],
        typeDesc: '<string>',
        forms: [],
        formDesc: '<string>'
      },
      proceedings: {
        name: '<string>',
        address: {
          street: '<string>',
          other: '<string>',
          city: '<string>',
          state: '<string>',
          zip: '<string>'
        },
        date: '<string>',
        time: {text: '<string>'},
        initiationDate: '<string>',
        docketNumber: '<string>',
        placeOfOtherProceedings: '<string>'
      },
      title: '<string>'
    },
    extraDesignees: [
      {
        name: '<string>',
        address: {
          street: '123 Main St',
          city: 'San Francisco',
          state: 'CA',
          zip: '94101',
          other: 'Apt 1'
        },
        cafNumber: '<string>',
        monitorIRSNotices: true
      }
    ]
  })
};

fetch('https://api.trychart.com/providers/irs/f8821/unsigned', 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.trychart.com/providers/irs/f8821/unsigned",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'personalInfo' => [
        'firstName' => 'John',
        'lastName' => 'Doe',
        'ssn' => '123456789'
    ],
    'address' => [
        'street' => '123 Main St',
        'city' => 'San Francisco',
        'state' => 'CA',
        'zip' => '94101',
        'other' => 'Apt 1'
    ],
    'form56' => [
        'authority' => [
                '1gDesc' => '<string>',
                '2a' => '<string>',
                '2b' => '<string>'
        ],
        'tax' => [
                '5' => '<string>',
                'types' => [
                                
                ],
                'typeDesc' => '<string>',
                'forms' => [
                                
                ],
                'formDesc' => '<string>'
        ],
        'proceedings' => [
                'name' => '<string>',
                'address' => [
                                'street' => '<string>',
                                'other' => '<string>',
                                'city' => '<string>',
                                'state' => '<string>',
                                'zip' => '<string>'
                ],
                'date' => '<string>',
                'time' => [
                                'text' => '<string>'
                ],
                'initiationDate' => '<string>',
                'docketNumber' => '<string>',
                'placeOfOtherProceedings' => '<string>'
        ],
        'title' => '<string>'
    ],
    'extraDesignees' => [
        [
                'name' => '<string>',
                'address' => [
                                'street' => '123 Main St',
                                'city' => 'San Francisco',
                                'state' => 'CA',
                                'zip' => '94101',
                                'other' => 'Apt 1'
                ],
                'cafNumber' => '<string>',
                'monitorIRSNotices' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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.trychart.com/providers/irs/f8821/unsigned"

	payload := strings.NewReader("{\n  \"personalInfo\": {\n    \"firstName\": \"John\",\n    \"lastName\": \"Doe\",\n    \"ssn\": \"123456789\"\n  },\n  \"address\": {\n    \"street\": \"123 Main St\",\n    \"city\": \"San Francisco\",\n    \"state\": \"CA\",\n    \"zip\": \"94101\",\n    \"other\": \"Apt 1\"\n  },\n  \"form56\": {\n    \"authority\": {\n      \"1gDesc\": \"<string>\",\n      \"2a\": \"<string>\",\n      \"2b\": \"<string>\"\n    },\n    \"tax\": {\n      \"5\": \"<string>\",\n      \"types\": [],\n      \"typeDesc\": \"<string>\",\n      \"forms\": [],\n      \"formDesc\": \"<string>\"\n    },\n    \"proceedings\": {\n      \"name\": \"<string>\",\n      \"address\": {\n        \"street\": \"<string>\",\n        \"other\": \"<string>\",\n        \"city\": \"<string>\",\n        \"state\": \"<string>\",\n        \"zip\": \"<string>\"\n      },\n      \"date\": \"<string>\",\n      \"time\": {\n        \"text\": \"<string>\"\n      },\n      \"initiationDate\": \"<string>\",\n      \"docketNumber\": \"<string>\",\n      \"placeOfOtherProceedings\": \"<string>\"\n    },\n    \"title\": \"<string>\"\n  },\n  \"extraDesignees\": [\n    {\n      \"name\": \"<string>\",\n      \"address\": {\n        \"street\": \"123 Main St\",\n        \"city\": \"San Francisco\",\n        \"state\": \"CA\",\n        \"zip\": \"94101\",\n        \"other\": \"Apt 1\"\n      },\n      \"cafNumber\": \"<string>\",\n      \"monitorIRSNotices\": true\n    }\n  ]\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.post("https://api.trychart.com/providers/irs/f8821/unsigned")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"personalInfo\": {\n    \"firstName\": \"John\",\n    \"lastName\": \"Doe\",\n    \"ssn\": \"123456789\"\n  },\n  \"address\": {\n    \"street\": \"123 Main St\",\n    \"city\": \"San Francisco\",\n    \"state\": \"CA\",\n    \"zip\": \"94101\",\n    \"other\": \"Apt 1\"\n  },\n  \"form56\": {\n    \"authority\": {\n      \"1gDesc\": \"<string>\",\n      \"2a\": \"<string>\",\n      \"2b\": \"<string>\"\n    },\n    \"tax\": {\n      \"5\": \"<string>\",\n      \"types\": [],\n      \"typeDesc\": \"<string>\",\n      \"forms\": [],\n      \"formDesc\": \"<string>\"\n    },\n    \"proceedings\": {\n      \"name\": \"<string>\",\n      \"address\": {\n        \"street\": \"<string>\",\n        \"other\": \"<string>\",\n        \"city\": \"<string>\",\n        \"state\": \"<string>\",\n        \"zip\": \"<string>\"\n      },\n      \"date\": \"<string>\",\n      \"time\": {\n        \"text\": \"<string>\"\n      },\n      \"initiationDate\": \"<string>\",\n      \"docketNumber\": \"<string>\",\n      \"placeOfOtherProceedings\": \"<string>\"\n    },\n    \"title\": \"<string>\"\n  },\n  \"extraDesignees\": [\n    {\n      \"name\": \"<string>\",\n      \"address\": {\n        \"street\": \"123 Main St\",\n        \"city\": \"San Francisco\",\n        \"state\": \"CA\",\n        \"zip\": \"94101\",\n        \"other\": \"Apt 1\"\n      },\n      \"cafNumber\": \"<string>\",\n      \"monitorIRSNotices\": true\n    }\n  ]\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.trychart.com/providers/irs/f8821/unsigned")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"personalInfo\": {\n    \"firstName\": \"John\",\n    \"lastName\": \"Doe\",\n    \"ssn\": \"123456789\"\n  },\n  \"address\": {\n    \"street\": \"123 Main St\",\n    \"city\": \"San Francisco\",\n    \"state\": \"CA\",\n    \"zip\": \"94101\",\n    \"other\": \"Apt 1\"\n  },\n  \"form56\": {\n    \"authority\": {\n      \"1gDesc\": \"<string>\",\n      \"2a\": \"<string>\",\n      \"2b\": \"<string>\"\n    },\n    \"tax\": {\n      \"5\": \"<string>\",\n      \"types\": [],\n      \"typeDesc\": \"<string>\",\n      \"forms\": [],\n      \"formDesc\": \"<string>\"\n    },\n    \"proceedings\": {\n      \"name\": \"<string>\",\n      \"address\": {\n        \"street\": \"<string>\",\n        \"other\": \"<string>\",\n        \"city\": \"<string>\",\n        \"state\": \"<string>\",\n        \"zip\": \"<string>\"\n      },\n      \"date\": \"<string>\",\n      \"time\": {\n        \"text\": \"<string>\"\n      },\n      \"initiationDate\": \"<string>\",\n      \"docketNumber\": \"<string>\",\n      \"placeOfOtherProceedings\": \"<string>\"\n    },\n    \"title\": \"<string>\"\n  },\n  \"extraDesignees\": [\n    {\n      \"name\": \"<string>\",\n      \"address\": {\n        \"street\": \"123 Main St\",\n        \"city\": \"San Francisco\",\n        \"state\": \"CA\",\n        \"zip\": \"94101\",\n        \"other\": \"Apt 1\"\n      },\n      \"cafNumber\": \"<string>\",\n      \"monitorIRSNotices\": true\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body
"<string>"
{
  "message": "<string>"
}

Authorizations

​
Authorization
string
header
required

Please use base64 encoded client_id:client_secret. You can use this command to generate the base64 encoded string: echo -n 'client_id:client_secret' | base64

Body

application/json
​
personalInfo
object
required
​
address
object
required
​
businessInfo
object
​
form56
object

IRS Form 56 (https://www.irs.gov/pub/irs-pdf/f56.pdf). Only required if the signer of the form 8821 is the fiduciary and not the taxpayer.

​
extraDesignees
object[]

Response

Unsigned IRS Form 8821 Response

The response is of type file.