---
updatedAt: 2026-08-03T16:15:16.000Z
agentTools:
  projectIndex: https://apidocs.taxbit.com/llms.txt
---

# Get Released Tax Documents

Retrieve released tax documents associated with a given account using your system's unique identifier for the Account. Returns the latest of each tax document and year by default.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/v1/accounts/{id}/tax-documents": {
      "get": {
        "description": "Retrieve released tax documents associated with a given account using your system's unique identifier for the Account. Returns the latest of each tax document and year by default.",
        "operationId": "AccountTaxDocumentsController_getAccountTaxDocuments",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Your system's unique identifier for the Account",
            "schema": {
              "type": "string",
              "example": "Account1234"
            }
          },
          {
            "name": "include_historical",
            "required": false,
            "in": "query",
            "description": "Retrieves all revisions of a user's released tax forms, potentially returning multiple revision numbers for each form type and year. When not passed, only the latest released tax document for each type and year is included in the response.",
            "schema": {
              "type": "boolean",
              "example": false
            }
          },
          {
            "name": "url_expiration_time",
            "required": false,
            "in": "query",
            "description": "Sets the URL expiration time in seconds. The default is 10 minutes. You can set the expiration time to a maximum of one hour.",
            "schema": {
              "type": "string",
              "example": "1000"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Account tax documents",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountTaxDocumentsResponseDto"
                },
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": [
                      {
                        "created_date": "2022-06-03T00:53:27.645Z",
                        "id": "a318aed6-386b-4ff2-b6c1-b253f0fdb0dc",
                        "revision": 1,
                        "type": "1099_B",
                        "revision_type": "ORIGINAL",
                        "url": "https://taxbit-staging-east1-document-service...id=GetObject",
                        "year": 2022,
                        "is_filed": true
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountsMessageResponseDto"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TooManyRequestsErrorResponseDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Get Released Tax Documents",
        "tags": [
          "Documents"
        ]
      }
    }
  },
  "info": {
    "title": "API",
    "description": "",
    "version": "1.2.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.multi1.enterprise.taxbit.com"
    },
    {
      "url": "https://api.eutax1.enterprise.taxbit.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "TooManyRequestsErrorResponseDto": {
        "type": "object",
        "properties": {
          "error": {
            "description": "Error code emitted when the caller exceeds its rate limit",
            "type": "string",
            "example": "rate_limit_exceeded"
          },
          "message": {
            "description": "How long to wait before retrying",
            "type": "string",
            "example": "Rate limit exceeded. Please retry after 30 seconds."
          }
        },
        "required": [
          "error",
          "message"
        ],
        "additionalProperties": false
      },
      "AccountsMessageResponseDto": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "example": "Bad Request"
          },
          "message": {
            "type": "string",
            "example": "Validation failed"
          }
        },
        "required": [
          "message"
        ],
        "additionalProperties": false
      },
      "AccountTaxDocumentsResponseDto": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "created_date": {
              "description": "ISO-8601 formatted date for the Tax Document creation timestamp.",
              "format": "date-time",
              "type": "string",
              "example": "2022-06-03T00:53:27.645Z"
            },
            "id": {
              "description": "Taxbit's unique identifier for the Tax Document (UUID).",
              "format": "uuid",
              "type": "string",
              "example": "a318aed6-386b-4ff2-b6c1-b253f0fdb0dc"
            },
            "revision": {
              "description": "Tax Document revision number.",
              "type": "number",
              "example": 1
            },
            "type": {
              "description": "Tax Document type.",
              "enum": [
                "1042_S",
                "1099_B",
                "1099_C",
                "1099_DA",
                "1099_DIV",
                "1099_INT",
                "1099_K",
                "1099_MISC",
                "1099_NEC",
                "1099_R",
                "5498",
                "CARF",
                "CRS",
                "DAC7",
                "GAIN_LOSS_SUMMARY",
                "GAIN_LOSS_SUMMARY_PDF",
                "RMD_STATEMENT",
                "TRANSACTION_SUMMARY",
                "TRANSACTION_SUMMARY_PDF",
                "UK_GAIN_LOSS_SUMMARY"
              ],
              "type": "string",
              "example": "1099_B"
            },
            "revision_type": {
              "description": "Indicates the type of the revision, or tax document.",
              "enum": [
                "CORRECTION",
                "ORIGINAL",
                "VOID"
              ],
              "type": "string",
              "example": "ORIGINAL"
            },
            "url": {
              "description": "Tax Document download URL.",
              "type": "string",
              "example": "https://taxbit-staging-east1-document-service...id=GetObject"
            },
            "year": {
              "description": "Tax Document year.",
              "type": "number",
              "example": 2022
            },
            "is_filed": {
              "description": "Indicates if the tax document has been filed to the relevant tax authority (ex. IRS) or if the tax document's final deliverable has been created (ex. DAC7 XML).",
              "type": "boolean",
              "example": true
            }
          },
          "additionalProperties": false,
          "title": "User tax document"
        }
      }
    }
  },
  "security": [
    {
      "bearer": []
    }
  ]
}
```