Skip to main content
GET
Get a return transcript
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 from the client credentials grant, sent as a Bearer credential.

Path Parameters

id
string<uuid>
required

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

Response

The transcript.

One return transcript.

id
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.

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.