> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taxrock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcripts overview

> The three transcript types, how to find a transcript, and paging.

The transcript endpoints return the IRS transcripts TaxRock holds for the taxpayers a credential can
access, as JSON. They work the same in both configurations. The links on this page go to the direct
access reference, and the [delegate access reference](https://docs.taxrock.com/delegate-access/api-reference/taxpayers/list.md)
has the same pages.

> [!NOTE]
>
> Responses return TINs, EINs and account numbers in full, except the account transcript's
> `primaryTin` and `spouseTin`, which are the last four digits. The examples in this reference use
> fake identifiers.

## Transcript types

* **Wage & Income**: the information returns, such as W-2s and 1099s, reported for one tax year, with a summary of the year.
* **Return**: one return for one tax period, its sections grouped by return, schedule or form.
* **Account**: the account for one form and tax period: header figures, a balance summary and transactions.

## Finding a transcript

**1. Find the taxpayer**

[List taxpayers](https://docs.taxrock.com/direct-access/api-reference/taxpayers/list.md) returns the taxpayers the credential can access.
[List client accounts](https://docs.taxrock.com/direct-access/api-reference/client-accounts/list.md) returns the client accounts the credential can access, each with its taxpayers.

**2. List the taxpayer's transcripts of one type**

[Wage & Income](https://docs.taxrock.com/direct-access/api-reference/taxpayers/wage-and-income.md),
[return](https://docs.taxrock.com/direct-access/api-reference/taxpayers/return.md) or
[account](https://docs.taxrock.com/direct-access/api-reference/taxpayers/account.md).

**3. Fetch one transcript by its id**

[Wage & Income](https://docs.taxrock.com/direct-access/api-reference/transcripts/wage-and-income.md),
[return](https://docs.taxrock.com/direct-access/api-reference/transcripts/return.md) or
[account](https://docs.taxrock.com/direct-access/api-reference/transcripts/account.md).

A taxpayer or transcript the credential cannot access returns `404`, the same as one that does not
exist.

`createdAt` is when TaxRock created the transcript record, and `updatedAt` is when TaxRock
last updated it, both in UTC.

## Paging

Three endpoints are paged, with the `page` (from 1) and `pageSize` query parameters.

| Endpoint | Default `pageSize` | Maximum `pageSize` |
| - | - | - |
| [List taxpayers](https://docs.taxrock.com/direct-access/api-reference/taxpayers/list.md) | 100 | 500 |
| [List client accounts](https://docs.taxrock.com/direct-access/api-reference/client-accounts/list.md) | 100 | 500 |
| [Get a Wage & Income transcript](https://docs.taxrock.com/direct-access/api-reference/transcripts/wage-and-income.md) (its `forms`) | 250 | 1,000 |

Each paged response carries `page`, `pageSize`, `totalCount` and `hasNextPage`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.