> ## 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 return transcripts > GET /taxpayers/{id}/transcripts/return Returns the taxpayer's return transcripts, without their sections. See the [Transcripts overview](https://docs.taxrock.com/api-reference/transcripts/overview.md). ## OpenAPI ````yaml api-reference/openapi-delegate.json GET /taxpayers/{id}/transcripts/return 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/return: get: tags: - Taxpayers summary: List a taxpayer's return transcripts description: >- Lists the taxpayer's return transcripts, without their sections. Requires the `read:client-accounts` scope. operationId: listReturnTranscripts 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 return transcripts. `transcripts` is empty when the taxpayer has none. content: application/json: schema: $ref: '#/components/schemas/ReturnTranscriptList' example: transcripts: - id: 00000000-0000-4000-8000-000000000001 form: name: '1040' taxYear: 2023 taxPeriod: 12 taxPeriodName: Annual createdAt: '2024-05-02T14:03:51Z' updatedAt: '2026-10-06T18:40:20Z' filed: true forms: - code: Form1040 count: 1 - code: ScheduleC count: 1 - code: Form8995 count: 1 - id: 00000000-0000-4000-8000-000000000002 form: name: '1040' taxYear: 2022 taxPeriod: 12 taxPeriodName: Annual createdAt: '2023-06-10T10:15:00Z' updatedAt: '2023-06-10T10:15:00Z' filed: false forms: - code: Form1040 count: 1 '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: ReturnTranscriptList: type: object description: A taxpayer's return transcripts. required: - transcripts properties: transcripts: type: array items: $ref: '#/components/schemas/ReturnTranscriptListItem' 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. ReturnTranscriptListItem: type: object description: One return transcript in a taxpayer's list, without its sections. required: - id - form - createdAt - updatedAt - filed - forms properties: id: type: string format: uuid description: The transcript's id, for Get a return 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. filed: type: boolean description: Whether the transcript shows a filed return. forms: type: array items: $ref: '#/components/schemas/ReturnFormCount' description: Counts of the transcript's `forms` entries by `code`. 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`.' ReturnFormCount: type: object required: - code - count properties: code: $ref: '#/components/schemas/ReturnFormCode' count: type: integer description: How many `forms` entries have this code. ReturnFormCode: type: string enum: - Unrecognized - Form1040 - Form1040NR - Form1065 - Form1120 - Form1120L - Form1120S - Form940 - Form941 - ScheduleA - ScheduleB - ScheduleC - ScheduleD - ScheduleE - ScheduleEIC - ScheduleF - ScheduleH - ScheduleJ - ScheduleK - ScheduleL - ScheduleM2 - ScheduleR - ScheduleSE - Form461 - Form1116 - Form2441 - Form2555 - Form3800 - Form4136 - Form4137 - Form4255 - Form4626 - Form4684 - Form4797 - Form4835 - Form4952 - Form5329 - Form5405 - Form5695 - Form5884B - Form6198 - Form6251 - Form6252 - Form8283 - Form8606 - Form8825 - Form8839 - Form8853 - Form8863 - Form8867 - Form8888 - Form8889 - Form8936 - Form8941 - Form8958 - Form8959 - Form8960 - Form8962 - Form8978 - Form8995 - Form8997 description: >- The return, schedule or form a `forms` entry holds, e.g. `Form1040`, `ScheduleC` or `Form8959`: - `Form2555`: Form 2555 or 2555-EZ. - `Form8995`: Form 8995 or 8995-A. - `ScheduleK`: Schedule K of the transcript's return. - `Unrecognized`: Sections not assigned to a listed form. Treat a code you do not know as `Unrecognized`. 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.