---
updatedAt: 2026-09-28T18:09:24.000Z
agentTools:
  projectIndex: https://docs.helix.q2.com/llms.txt
---

# Download a statement

Download the PDF content of a monthly or tax statement for the given `customerId`.

#### Error Codes

<details>
  <summary>Click to expand</summary>

| Code    | Message (en-US)                                                                   | Notes                                            |
| :------ | :-------------------------------------------------------------------------------- | :----------------------------------------------- |
| 1-60000 | Any "Common Error Code" may occur.                                                | See [Common Error Codes](https://docs.helix.q2.com/reference/common-error-codes) |
| 67101   | A statementId is required.                                                        |                                                  |
| 67102   | The requested statementId = {0} is invalid.                                       |                                                  |
| 67103   | The requested statementId = {0} is configured improperly. Please contact support. |                                                  |
| 67104   | The requested statementId = {0} could not be located.                             |                                                  |

</details>

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Helix API",
    "version": "3.0.0",
    "description": "Helix Public API (no customer KYC/IDV). **This spec covers all of Helix 3.x and is subject to change at any time.**"
  },
  "servers": [
    {
      "url": "https://sandbox-api.helix.q2.com",
      "description": "Sandbox server"
    },
    {
      "url": "https://api.helix.q2.com",
      "description": "Production server"
    }
  ],
  "tags": [
    {
      "name": "Card",
      "description": "Endpoints for the card object"
    },
    {
      "name": "Statement",
      "description": "Endpoints for the statement object"
    }
  ],
  "security": [
    {
      "basicAuth": []
    }
  ],
  "paths": {
    "/card/lock": {
      "post": {
        "tags": [
          "Card"
        ],
        "summary": "Lock a card",
        "description": "Lock a card. Most locks can be reversed by calling [/card/unlock](https://docs.helix.q2.com/reference/cardunlock). Please check the [/card/unlock](https://docs.helix.q2.com/reference/cardunlock) documentation to see which lock scenarios can be subsequently unlocked. Will apply a `lockTypeCode` of `CST` on success and all card-based transactions will fail.",
        "externalDocs": {
          "url": "https://docs.helix.q2.com/reference/cardlock"
        },
        "operationId": "cardLock",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "customerId",
                  "cardId",
                  "lockReasonTypeCode"
                ],
                "properties": {
                  "customerId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "cardId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "lockReasonTypeCode": {
                    "type": "string",
                    "enum": [
                      "UNK",
                      "FRD",
                      "DMG",
                      "TMP"
                    ],
                    "description": "- `UNK`: Unknown\n- `FRD`: Fraud\n- `DMG`: Physical Damage\n- `TMP`: Temporary\n"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "An <a href=\"https://docs.helix.q2.com/reference/response-format\" target=\"_blank\">envelope</a> whose data node is a <a href=\"https://docs.helix.q2.com/docs/card\" target=\"_blank\">card</a> object",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CardObject200Response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "$ref": "#/components/schemas/HelixId"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "example": "b75a96f8-2fbc-4b14-9ba4-7b06aa431c9d"
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        400
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50401
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "User is not authorized"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "enum": [
                        "00000000-0000-0000-0000-000000000000"
                      ]
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        401
                      ]
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50404
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "The requested resource 'https://sandbox-api.helix.q2.com/customer/updat/805592' was not found"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "example": "b75a96f8-2fbc-4b14-9ba4-7b06aa431c9d"
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        404
                      ]
                    }
                  }
                }
              }
            }
          },
          "405": {
            "description": "HTTP Method Not Allowed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50405
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "The HTTP method 'POST' for requested resource 'https://sandbox-api.helix.q2.com/customer/get/805594' is not allowed."
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "enum": [
                        "00000000-0000-0000-0000-000000000000"
                      ]
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        405
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50429
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "Rate limit exceeded"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "enum": [
                        "00000000-0000-0000-0000-000000000000"
                      ]
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        429
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/statement/download/{customerId}/{statementId}": {
      "get": {
        "tags": [
          "Statement"
        ],
        "summary": "Download a statement",
        "description": "Download the PDF content of a monthly or tax statement for the given `customerId`.",
        "externalDocs": {
          "url": "https://docs.helix.q2.com/reference/statementdownload"
        },
        "operationId": "statementDownload",
        "parameters": [
          {
            "$ref": "#/components/parameters/CustomerIdPath"
          },
          {
            "$ref": "#/components/parameters/StatementIdPath"
          }
        ],
        "responses": {
          "200": {
            "description": "A <a href=\"https://docs.helix.q2.com/docs/file-content\" target=\"_blank\">fileContent</a> object",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FileContentObject200Response"
                }
              }
            }
          },
          "400": {
            "$ref": "#/paths/~1card~1lock/post/responses/400"
          },
          "401": {
            "$ref": "#/paths/~1card~1lock/post/responses/401"
          },
          "404": {
            "$ref": "#/paths/~1card~1lock/post/responses/404"
          },
          "405": {
            "$ref": "#/paths/~1card~1lock/post/responses/405"
          },
          "429": {
            "$ref": "#/paths/~1card~1lock/post/responses/429"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AccountClose200Response": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CardArray200Response/allOf/0"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "properties": {
                  "customerId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "accountId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "closeToAccountId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "transactionId": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  },
                  "transactionTag": {
                    "$ref": "#/components/schemas/TagProperty"
                  },
                  "closingBalanceAmount": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "interestPaidAmount": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "totalClosingAmount": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "isClosedToExternalAccount": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        ]
      },
      "CardArray200Response": {
        "allOf": [
          {
            "type": "object",
            "properties": {
              "errors": {
                "type": "array",
                "items": {},
                "example": []
              },
              "requestId": {
                "type": "string",
                "example": "1249a3bf-aca1-40dd-9fba-2a3193550c39"
              },
              "status": {
                "type": "integer",
                "enum": [
                  200
                ]
              },
              "throttle": {
                "type": "object",
                "properties": {
                  "periodEndsAt": {
                    "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                  },
                  "periodLengthInSeconds": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "periodRequestLimit": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "requestsRemainingInPeriod": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "warningThreshold": {
                    "type": "number",
                    "format": "decimal",
                    "example": 0.2
                  }
                }
              }
            }
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CardObject200Response/allOf/1/properties/data"
                }
              }
            }
          }
        ]
      },
      "CustomerSetLastContact200Response": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CardArray200Response/allOf/0"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "customerId": {
                      "$ref": "#/components/schemas/HelixId"
                    },
                    "dormancyStatus": {
                      "type": "string",
                      "enum": [
                        "Active",
                        "Inactive",
                        "Dormant"
                      ]
                    },
                    "lastContactDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2021-01-07T19:00:59.761-06:00"
                    },
                    "lastContactType": {
                      "$ref": "#/components/schemas/LastContactType"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "FileContentObject200Response": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CardArray200Response/allOf/0"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string",
                    "format": "byte"
                  },
                  "contentLength": {
                    "$ref": "#/components/schemas/AccountClose200Response/allOf/1/properties/data/properties/transactionId"
                  },
                  "contentType": {
                    "type": "string"
                  }
                }
              }
            }
          }
        ]
      },
      "HelixId": {
        "type": "integer",
        "format": "int32",
        "minimum": 1
      }
    },
    "parameters": {
      "CustomerIdPath": {
        "name": "customerId",
        "in": "path",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/HelixId"
        }
      },
      "StatementIdPath": {
        "name": "statementId",
        "in": "path",
        "required": true,
        "schema": {
          "type": "integer",
          "format": "int64",
          "minimum": 1
        }
      }
    },
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "x-samples-languages": [
    "curl",
    "node",
    "python",
    "csharp",
    "ruby",
    "go",
    "java",
    "kotlin",
    "php"
  ]
}
```