> ## 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 Wage & Income transcripts

> GET /taxpayers/{id}/transcripts/wage-and-income

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


## OpenAPI

````yaml api-reference/openapi-delegate.json GET /taxpayers/{id}/transcripts/wage-and-income
openapi: 3.1.0
info:
  title: TaxRock API (delegate access)
  version: 1.0.0
  description: >-
    The TaxRock API with delegate access: reads what a connected TaxRock user
    can access, after the user consents once. See Getting started.
servers:
  - url: https://delegate-demo.api.taxrock.com
    description: Sandbox
security:
  - bearerAuth: []
paths:
  /taxpayers/{id}/transcripts/wage-and-income:
    get:
      tags:
        - Taxpayers
      summary: List a taxpayer's Wage & Income transcripts
      description: >-
        Lists the taxpayer's Wage & Income transcripts, without their forms.
        Requires the `read:client-accounts` scope.
      operationId: listWageAndIncomeTranscripts
      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 Wage & Income transcripts. `transcripts` is empty
            when the taxpayer has none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WageAndIncomeTranscriptList'
              example:
                transcripts:
                  - id: 00000000-0000-4000-8000-000000000001
                    form:
                      name: ALL FORMS
                      taxYear: 2023
                      taxPeriod: 12
                      taxPeriodName: Annual
                    createdAt: '2024-02-08T11:20:44Z'
                    updatedAt: '2026-09-25T15:12:40Z'
                    requestedDataNotFound: false
                    forms:
                      - formName: 1099-DA
                        count: 1
                      - formName: 1099-INT
                        count: 1
                      - formName: W-2
                        count: 1
                  - id: 00000000-0000-4000-8000-000000000002
                    form:
                      name: ALL FORMS
                      taxYear: 2022
                      taxPeriod: 12
                      taxPeriodName: Annual
                    createdAt: '2023-03-01T09:00:10Z'
                    updatedAt: '2023-03-01T09:00:10Z'
                    requestedDataNotFound: true
                    forms: []
        '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. Refresh the token, or send the user
            back through the authorization flow.
        '403':
          description: >-
            `error` is `insufficient_scope` when the token lacks the
            `read:client-accounts` scope, or `forbidden` when the connected user
            is not eligible or lacks permission.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              examples:
                insufficientScope:
                  summary: Token missing the required scope
                  value:
                    error: insufficient_scope
                    message: >-
                      Access token is missing the required scope. Re-run
                      authorize requesting: read:client-accounts.
                forbidden:
                  summary: User not eligible or not permitted
                  value:
                    error: forbidden
                    message: Caller lacks the required permission.
        '404':
          description: >-
            The taxpayer does not exist, or the connected user cannot access it.
            `error` is `not_found`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
              example:
                error: not_found
                message: Taxpayer not found.
components:
  schemas:
    WageAndIncomeTranscriptList:
      type: object
      description: A taxpayer's Wage & Income transcripts.
      required:
        - transcripts
      properties:
        transcripts:
          type: array
          items:
            $ref: '#/components/schemas/WageAndIncomeTranscriptListItem'
          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.
    WageAndIncomeTranscriptListItem:
      type: object
      description: One Wage & Income transcript in a taxpayer's list, without its forms.
      required:
        - id
        - form
        - createdAt
        - updatedAt
        - requestedDataNotFound
        - forms
      properties:
        id:
          type: string
          format: uuid
          description: The transcript's id, for Get a Wage & Income 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 for the year.
        forms:
          type: array
          items:
            $ref: '#/components/schemas/FormCount'
          description: Form counts by form name.
    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`.'
    FormCount:
      type: object
      required:
        - formName
        - count
      properties:
        formName:
          type: string
          description: An information return type, e.g. `W-2`.
        count:
          type: integer
          description: How many forms of that type the transcript holds.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        The access token obtained from the OAuth flow, sent as a Bearer
        credential.

````

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