Get a return transcript

curl --request GET \
  --url https://delegate-demo.api.taxrock.com/transcripts/return/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://delegate-demo.api.taxrock.com/transcripts/return/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://delegate-demo.api.taxrock.com/transcripts/return/{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://delegate-demo.api.taxrock.com/transcripts/return/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://delegate-demo.api.taxrock.com/transcripts/return/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://delegate-demo.api.taxrock.com/transcripts/return/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "00000000-0000-4000-8000-000000000001",
  "taxpayerId": "00000000-0000-4000-8000-0000000000a2",
  "form": {
    "name": "1040",
    "taxYear": 2023,
    "taxPeriod": 12,
    "taxPeriodName": "Annual"
  },
  "createdAt": "2024-05-02T14:03:51Z",
  "updatedAt": "2026-10-06T18:40:20Z",
  "filed": true,
  "receivedDate": "2024-04-15",
  "adjustedGrossIncome": 397195,
  "filingStatus": "MarriedFilingJoint",
  "filingStatusRaw": "Married Taxpayer Filing Joint Return",
  "forms": [
    {
      "code": "Form1040",
      "occurrence": 1,
      "sections": [
        {
          "name": "",
          "lineItems": [
            {
              "label": "Request Date",
              "column": null,
              "rawValue": "10-06-2026",
              "type": "Date",
              "value": "2026-10-06"
            }
          ],
          "subsections": []
        },
        {
          "name": "",
          "lineItems": [
            {
              "label": "SSN provided",
              "column": null,
              "rawValue": "000-00-0000",
              "type": "String",
              "value": "000-00-0000"
            },
            {
              "label": "Report for Tax Period Ending",
              "column": null,
              "rawValue": "12-31-2023",
              "type": "Date",
              "value": "2023-12-31"
            }
          ],
          "subsections": []
        },
        {
          "name": "Income",
          "lineItems": [
            {
              "label": "Adjusted gross income",
              "column": null,
              "rawValue": "$397,195.00",
              "type": "Currency",
              "value": 397195
            }
          ],
          "subsections": []
        }
      ]
    },
    {
      "code": "ScheduleC",
      "occurrence": 1,
      "sections": [
        {
          "name": "Schedule C - Profit or Loss From Business (Occurrence #: 1)",
          "lineItems": [
            {
              "label": "Social Security Number",
              "column": null,
              "rawValue": "000-00-0000",
              "type": "String",
              "value": "000-00-0000"
            },
            {
              "label": "Employer ID number",
              "column": null,
              "rawValue": "00-0000000",
              "type": "String",
              "value": "00-0000000"
            },
            {
              "label": "Business name",
              "column": null,
              "rawValue": "EXAMPLE CONSULTING",
              "type": "String",
              "value": "EXAMPLE CONSULTING"
            },
            {
              "label": "Gross receipts or sales",
              "column": null,
              "rawValue": "$120,000.00",
              "type": "Currency",
              "value": 120000
            }
          ],
          "subsections": []
        }
      ]
    },
    {
      "code": "Form8995",
      "occurrence": 1,
      "sections": [
        {
          "name": "Form 8995 - A/8995 Qualified Business Income Deduction",
          "lineItems": [
            {
              "label": "Qualified business income deduction",
              "column": null,
              "rawValue": "$21,000.00",
              "type": "Currency",
              "value": 21000
            }
          ],
          "subsections": []
        }
      ]
    }
  ]
}

GET

transcripts

return

{id}

Get a return transcript

curl --request GET \
  --url https://delegate-demo.api.taxrock.com/transcripts/return/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://delegate-demo.api.taxrock.com/transcripts/return/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://delegate-demo.api.taxrock.com/transcripts/return/{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://delegate-demo.api.taxrock.com/transcripts/return/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://delegate-demo.api.taxrock.com/transcripts/return/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://delegate-demo.api.taxrock.com/transcripts/return/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "00000000-0000-4000-8000-000000000001",
  "taxpayerId": "00000000-0000-4000-8000-0000000000a2",
  "form": {
    "name": "1040",
    "taxYear": 2023,
    "taxPeriod": 12,
    "taxPeriodName": "Annual"
  },
  "createdAt": "2024-05-02T14:03:51Z",
  "updatedAt": "2026-10-06T18:40:20Z",
  "filed": true,
  "receivedDate": "2024-04-15",
  "adjustedGrossIncome": 397195,
  "filingStatus": "MarriedFilingJoint",
  "filingStatusRaw": "Married Taxpayer Filing Joint Return",
  "forms": [
    {
      "code": "Form1040",
      "occurrence": 1,
      "sections": [
        {
          "name": "",
          "lineItems": [
            {
              "label": "Request Date",
              "column": null,
              "rawValue": "10-06-2026",
              "type": "Date",
              "value": "2026-10-06"
            }
          ],
          "subsections": []
        },
        {
          "name": "",
          "lineItems": [
            {
              "label": "SSN provided",
              "column": null,
              "rawValue": "000-00-0000",
              "type": "String",
              "value": "000-00-0000"
            },
            {
              "label": "Report for Tax Period Ending",
              "column": null,
              "rawValue": "12-31-2023",
              "type": "Date",
              "value": "2023-12-31"
            }
          ],
          "subsections": []
        },
        {
          "name": "Income",
          "lineItems": [
            {
              "label": "Adjusted gross income",
              "column": null,
              "rawValue": "$397,195.00",
              "type": "Currency",
              "value": 397195
            }
          ],
          "subsections": []
        }
      ]
    },
    {
      "code": "ScheduleC",
      "occurrence": 1,
      "sections": [
        {
          "name": "Schedule C - Profit or Loss From Business (Occurrence #: 1)",
          "lineItems": [
            {
              "label": "Social Security Number",
              "column": null,
              "rawValue": "000-00-0000",
              "type": "String",
              "value": "000-00-0000"
            },
            {
              "label": "Employer ID number",
              "column": null,
              "rawValue": "00-0000000",
              "type": "String",
              "value": "00-0000000"
            },
            {
              "label": "Business name",
              "column": null,
              "rawValue": "EXAMPLE CONSULTING",
              "type": "String",
              "value": "EXAMPLE CONSULTING"
            },
            {
              "label": "Gross receipts or sales",
              "column": null,
              "rawValue": "$120,000.00",
              "type": "Currency",
              "value": 120000
            }
          ],
          "subsections": []
        }
      ]
    },
    {
      "code": "Form8995",
      "occurrence": 1,
      "sections": [
        {
          "name": "Form 8995 - A/8995 Qualified Business Income Deduction",
          "lineItems": [
            {
              "label": "Qualified business income deduction",
              "column": null,
              "rawValue": "$21,000.00",
              "type": "Currency",
              "value": 21000
            }
          ],
          "subsections": []
        }
      ]
    }
  ]
}

Returns one return transcript, its sections grouped in forms by return, schedule or form. See the Transcripts overview.

Authorizations

Authorization

string

header

required

The access token obtained from the OAuth flow, sent as a Bearer credential.

Path Parameters

string<uuid>

required

The transcript's id, from the taxpayer's list of return transcripts.

Response

The transcript.

One return transcript.

string<uuid>

required

The transcript's id.

taxpayerId

string<uuid>

required

The taxpayer's id.

form

object

required

The form, year and period a transcript covers.

Show child attributes

createdAt

string<date-time>

required

When TaxRock created this transcript record, in UTC.

updatedAt

string<date-time>

required

When TaxRock last updated this transcript record, in UTC.

filed

boolean

required

Whether the transcript shows a filed return.

receivedDate

string<date> | null

required

The date the return was received.

adjustedGrossIncome

number | null

required

Adjusted gross income as filed.

filingStatus

enum<string> | null

required

The printed filing status as one of five values. Null when none is printed or it does not match one.

Available options:

Single,

MarriedFilingJoint,

MarriedFilingSeparate,

HeadOfHousehold,

QualifyingSurvivingSpouse

filingStatusRaw

string | null

required

The filing status as printed.

forms

object[]

required

The transcript's sections, grouped by return, schedule or form.

Show child attributes

OAuth

Client Accounts

Taxpayers

Transcripts

TIN Verification

Get a return transcript

Authorizations

Path Parameters

Response