# API

## Create Tax Form Request (Business)

<mark style="color:green;">`POST`</mark> `https://app.moderntax.io/api/v1/tax-form-requests`

Create a transcript request for an individual business.

Supports requesting transcripts for multiple years ie: "years": \[2017, 2020, 2021]

#### Headers

| Name                                                | Type   | Description  |
| --------------------------------------------------- | ------ | ------------ |
| MODERNTAX-API-KEY<mark style="color:red;">\*</mark> | String | Add your API |

#### Request Body

| Name                                       | Type   | Description                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| business<mark style="color:red;">\*</mark> | Object | <p>Request Example:</p><p></p><p>{</p><p>  "tax\_form\_request": {</p><p>    "business": {</p><p>      "name": "ModernTax",</p><p>      "taxpayer\_id": "12-12345678",</p><p>      "address": "...",</p><p>      "phone\_number": "(XXX)XXX-XXXX",</p><p>      "signator\_name": "John Doe",</p><p>      "signator\_title": "CTO",</p><p>    }</p><p>}</p> |
| years<mark style="color:red;">\*</mark>    | Array  | \["2020", "2021"]                                                                                                                                                                                                                                                                                                                                          |

{% tabs %}
{% tab title="200 Transcript" %}

```
{ 
  "taxpayer_id": "7a3fa0bf-0352-4e17-8e5f-482fee5d9f4b",
  "business_name": "ModernTax",
  "created_at": "2021-03-11T16:38:57.099Z",
  "transcripts": [
    {
      "id": 98,
      "name": "FormName",
      "created_at": "2021-03-25T23:06:25.932Z",
      "pdf_url": "https://moderntaxstorage.s3...",
      "summary": "..."
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Create Tax Form Request (Individual)

<mark style="color:green;">`POST`</mark> `https://app.moderntax.io/api/v1/tax-form-requests`

Create a transcript request for an individual.

Currently, there is only support for requesting a single year for an individual ie: "years": \[2019]

#### Headers

| Name                                                | Type   | Description  |
| --------------------------------------------------- | ------ | ------------ |
| MODERNTAX-API-KEY<mark style="color:red;">\*</mark> | String | Add your API |

#### Request Body

| Name                                       | Type   | Description                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| business<mark style="color:red;">\*</mark> | Object | <p>Request Example:</p><p></p><p>{</p><p>  "tax\_form\_request":</p><p>     {</p><p>       "individual": {</p><p>         "name": "Full Name",</p><p>         "taxpayer\_id": "XXX-XX-XXXX",</p><p>         "address": "Address"</p><p>       },</p><p>       "form\_type": "1040",</p><p>       "years": \[2019]</p><p>  }</p><p>}</p> |
| years<mark style="color:red;">\*</mark>    | Array  | \[Single Year]                                                                                                                                                                                                                                                                                                                          |

{% tabs %}
{% tab title="200 Transcript" %}

```
{ 
  "success": true,
  "created_at": "2021-03-11T16:38:57.099Z",
  "transcripts": [{...}]
}
```

{% endtab %}
{% endtabs %}

## Create Multiple Tax Form Requests

<mark style="color:green;">`POST`</mark> `https://app.moderntax.io/api/v1/tax-form-requests/bulk-upload`

Bulk multiple tax form requests within a single post request.

#### Headers

| Name                                                | Type   | Description |
| --------------------------------------------------- | ------ | ----------- |
| MODERNTAX-API-KEY<mark style="color:red;">\*</mark> | String | API Key     |

#### Request Body

| Name                               | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:red;">\*</mark> | Object | <p>Request Example:</p><p></p><p>\[{ "tax\_form\_request":</p><p>    { "business": { "name": "Company 1", "taxpayer\_id": "23-3222435", "address": "3143 10th st, San Francisco, CA, 94101, "phone\_number": "555-1234", "signator": "John Doe", "signator\_title": "ABC" }, "years": \["2021"] }</p><p>},</p><p>{ "tax\_form\_request":</p><p>  { "business": { "name": "Company 1", "taxpayer\_id": "23-3222434", "address": "3142 10th st, San Francisco, CA, 94101", "phone\_number": "555-1234", "signator": "John Doe", "signator\_title": "ABC" }, "years": \["2021"] }</p><p>}]</p> |

{% tabs %}
{% tab title="200 " %}

```
{ 
  "taxpayer_id": "7a3fa0bf-0352-4e17-8e5f-482fee5d9f4b",
  "full_name": "John Smith",
  "created_at": "2021-03-11T16:38:57.099Z",
  "transcripts": [
    {
      "id": 98,
      "name": "201712_Verification of Non-Filing_SMIT",
      "created_at": "2021-03-25T23:06:25.932Z",
      "pdf_url": "https://moderntaxstorage.s3..."
    },
    {
      "id": 99,
      "name": "201812_Tax Return Transcript_SMIT",
      "created_at": "2021-03-25T23:06:25.932Z",
      "pdf_url": "https://moderntaxstorage.s3..."
    }
  ]
}
```

{% endtab %}
{% endtabs %}