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

# List a taxpayer's account transcripts

> GET /taxpayers/{id}/transcripts/account

Returns the taxpayer's account transcripts, without their transactions.
See the [Transcripts overview](https://docs.taxrock.com/api-reference/transcripts/overview.md).


## OpenAPI

````yaml api-reference/openapi-direct.json GET /taxpayers/{id}/transcripts/account
openapi: 3.1.0
info:
  title: TaxRock API (direct access)
  version: 1.0.0
  description: >-
    The TaxRock API with direct access: a credential issued for a TaxRock
    organization reads that organization's data. See Getting started.
servers:
  - url: https://api-demo.taxrock.com
    description: Sandbox
security:
  - bearerAuth: []
paths:
  /taxpayers/{id}/transcripts/account:
    get:
      tags:
        - Taxpayers
      summary: List a taxpayer's account transcripts
      description: Lists the taxpayer's account transcripts, without their transactions.
      operationId: listAccountTranscripts
      parameters:
        - name: id
          in: path
          required: true
          description: The taxpayer's `id`, from List taxpayers or List client accounts.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: >-
            The taxpayer's account transcripts. `transcripts` is empty when the
            taxpayer has none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountTranscriptList'
              example:
                transcripts:
                  - id: 00000000-0000-4000-8000-000000000001
                    form:
                      name: '1040'
                      taxYear: 2023
                      taxPeriod: 12
                      taxPeriodName: Annual
                    createdAt: '2025-06-13T20:38:39Z'
                    updatedAt: '2025-07-29T10:20:45Z'
                    requestedDataNotFound: false
                  - id: 00000000-0000-4000-8000-000000000002
                    form:
                      name: '1040'
                      taxYear: 2022
                      taxPeriod: 12
                      taxPeriodName: Annual
                    createdAt: '2025-06-13T20:38:41Z'
                    updatedAt: '2025-06-13T20:38:41Z'
                    requestedDataNotFound: true
        '400':
          description: The `id` is not a valid UUID. `error` is `invalid_request`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              examples:
                invalidRequest:
                  summary: Malformed value
                  value:
                    error: invalid_request
                    message: The value 'abc' is not valid.
        '401':
          description: Missing or invalid access token. Get a new token.
        '403':
          description: >-
            `error` is `forbidden` when the credential is not set up for direct
            access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              examples:
                forbidden:
                  summary: Credential not set up for direct access
                  value:
                    error: forbidden
                    message: This client is not authorized for direct access.
        '404':
          description: >-
            The taxpayer does not exist or is outside the credential's
            organization. `error` is `not_found`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
              example:
                error: not_found
                message: Taxpayer not found.
components:
  schemas:
    AccountTranscriptList:
      type: object
      description: A taxpayer's account transcripts.
      required:
        - transcripts
      properties:
        transcripts:
          type: array
          items:
            $ref: '#/components/schemas/AccountTranscriptListItem'
          description: The taxpayer's transcripts of this type.
    ApiError:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          description: Machine-readable error code, e.g. `invalid_request` or `forbidden`.
        message:
          type: string
          description: Human-readable explanation.
    NotFoundError:
      type: object
      description: The 404 body of the transcript endpoints.
      required:
        - error
        - message
      properties:
        error:
          type: string
          enum:
            - not_found
          description: The error code.
        message:
          type: string
          description: Human-readable explanation.
    AccountTranscriptListItem:
      type: object
      description: One account transcript in a taxpayer's list, without its transactions.
      required:
        - id
        - form
        - createdAt
        - updatedAt
        - requestedDataNotFound
      properties:
        id:
          type: string
          format: uuid
          description: The transcript's id, for Get an account transcript.
        form:
          $ref: '#/components/schemas/TranscriptForm'
        createdAt:
          type: string
          format: date-time
          description: When TaxRock created this transcript record, in UTC.
        updatedAt:
          type: string
          format: date-time
          description: When TaxRock last updated this transcript record, in UTC.
        requestedDataNotFound:
          type: boolean
          description: True when the transcript holds no data.
    TranscriptForm:
      type: object
      description: The form, year and period a transcript covers.
      required:
        - name
        - taxYear
        - taxPeriod
        - taxPeriodName
      properties:
        name:
          type: string
          description: The form name in upper case, e.g. `1040`, `941` or `ALL FORMS`.
        taxYear:
          type: integer
          description: The tax year.
        taxPeriod:
          type: integer
          description: >-
            The period's last month: 12 for an annual form, or 3, 6, 9 or 12 for
            a quarterly one.
        taxPeriodName:
          type: string
          description: '`Annual`, or `Q1` to `Q4`.'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        The access token from the client credentials grant, sent as a Bearer
        credential.

````

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