---
title: "file-conversion/history"
method: GET
path: "/file-conversion/history"
tags: ["File Conversion Endpoints"]
---

# file-conversion/history

`GET /file-conversion/history`

Get file conversion history for your account with optional filtering and pagination.

## Query parameters

- `AccountID` string, required
- `Key` string, required
- `Signature` string, required
- `Processor` 'bmo' | 'crossriver' | 'dc_bank' | 'fiserv' | 'globalpay' | 'goldmansachs' | 'mastercard' | 'nuvei' | 'peoples_trust_bank' | 'scotia_bank' | 'worldpay' | 'bankofamerica'
- `ConversionStatus` 'Success' | 'Failed' | 'Processing' | 'Uploaded' | 'Submitted' | 'Submission In Progress'
- `PaymentRail` 'interac' | 'eft' | 'vopayinstant' | 'ach' | 'rtp' | 'fednow' | 'fedwire' | 'aft' | 'oct' | 'creditcard' | 'debitcard'
- `Service` 'Debit' | 'Credit'
- `StartDate` string, date
- `EndDate` string, date
- `Limit` integer
- `Offset` integer
- `Timezone` string

## Response `200`

- object
  - `Success` boolean — True if the request was successful, false if it failed
  - `ErrorMessage` string — Contains a description of the error if the request failed
  - `NumberOfRecords` integer — Number of conversion records returned in this response
  - `Conversions` object — Collection of file conversion history records
    - `0` object — File conversion record
      - `FileConversionID` string — Unique ID of the file conversion
      - `Processor` string — The processor/banking partner used for this conversion
      - `PaymentRail` string — The payment rail used for this conversion
      - `AlternatePaymentRail` string — The alternate payment rail used for this conversion
      - `Service` string — Service type: Debit or Credit
      - `SourceFileName` string — Name of the uploaded source file
      - `TransactionCount` string — Number of transactions in the file
      - `TotalAmount` string — Total amount of all transactions in the file
      - `Currency` string — 3 character currency code
      - `TotalFailed` string — Number of failed transactions
      - `ConversionStatus` string — Current status of the conversion
      - `ErrorMessage` string — Error message if the conversion failed
      - `IsSubmitted` string — Whether the file has been submitted (1 = yes, 0 = no)
      - `SubmittedDate` string — Date and time the file was submitted
      - `DateAdded` string — Date and time the file was uploaded
      - `TotalAmounts` object — Breakdown of total amounts by category
  - `PaginationMetaData` object — Pagination metadata
    - `TotalRecords` integer — Total number of records matching the filter criteria
    - `Offset` integer — Current offset in the dataset
    - `Limit` integer — Maximum number of records returned per request

---

[API](https://skmtc.net/vopay/apis/accounts.md) · [All operations](https://skmtc.net/vopay/apis/accounts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vopay/accounts/revisions/7033bd231ec7/schema)