---
title: Count the number of processed transactions
description: api
---

[Skip to content](https://help.ecomcharge.com/en/knowledge-base/api-count-the-number-of-processed-transactions-v2#main-content)

- [English](https://help.ecomcharge.com/en/knowledge-base/api-count-the-number-of-processed-transactions-v2)
- [Русский](https://help.ecomcharge.com/knowledge-base-ru/api-count-the-number-of-processed-transactions-v2)

English

Show submenu for translations

[Customer portal](https://help.ecomcharge.com/tickets?hsLang=en)

- [Subscribe to platform updates](https://share-eu1.hsforms.com/1iuchcnmzT9yq2VKMCRdsLwfnh6h)
- [Support & Requests](https://help.ecomcharge.com/en/knowledge-base/support-requests)

Open main navigation

Close main navigation

- [Subscribe to platform updates](https://share-eu1.hsforms.com/1iuchcnmzT9yq2VKMCRdsLwfnh6h)
- [Support & Requests](https://help.ecomcharge.com/en/knowledge-base/support-requests)
- - [English](https://help.ecomcharge.com/en/knowledge-base/api-count-the-number-of-processed-transactions-v2)
    - [Русский](https://help.ecomcharge.com/knowledge-base-ru/api-count-the-number-of-processed-transactions-v2)

  English
  
  Show submenu for translations
- [Customer portal](https://help.ecomcharge.com/tickets)
- [eComCharge Blog](https://ecomcharge.com/blog/)

[eComCharge Blog](https://ecomcharge.com/blog/)

 This is a search field with an auto-suggest feature attached.

- There are no suggestions because the search field is empty.

1. [eComCharge knowledge base](https://help.ecomcharge.com/en/knowledge-base?hsLang=en)
2. [PSP API documentation](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en)
3. [Transactions (DWH v.2)](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#transactions-dwh-v-2)

# Count the number of processed transactions

### Request

The requests must:

- use [HTTP Basic authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication#Basic_authentication_scheme) with [your PSP ID and secret key](https://psp-doc.begateway.com/en/introduction/psp_secret_key/) as a username and a password respectively;
- have the `Content-Type` header set to `application/json`;
- have the `Accept` header set to `application/json`;
- be UTF-8 encoded.

Send a `POST` request to `{YOUR DWH URL}/api/v2/transactions/count` with the following parameters:

| **Parameter** | **Type** | **Description** | **Partial match** |
| --- | --- | --- | --- |
| options | object |  | N/A |
| time\_zone | string | The PSP timezone as defined [here](https://manpages.ubuntu.com/manpages/trusty/man3/DateTime::TimeZone::Catalog.3pm.html), for example, `Europe/Vilnius`. Default value is `Etc/UTC`. Make sure to send this parameter if your timezone is different from UTC+00:00. | N/A |
| filter | object |  | N/A |
| date\_from \* required | string | A start date of the reporting period in ISO 8601 format — `YYYY-MM-DDThh:mm:ss±hh:mm` or `YYYY-MM-DDThh:mm:ss`, for example, `2024-01-24T23:13:39+03:00`. The timezone in the parameter value must match the one specified in `options.time_zone`. The date must occur within 90 days before the value of the `date_to` parameter. | N/A |
| date\_to \* required | string | An end date of the reporting period in ISO 8601 format — `YYYY-MM-DDThh:mm:ss±hh:mm` or `YYYY-MM-DDThh:mm:ss`, for example `2024-01-24T23:13:39+03:00`. The timezone in the parameter value must match the one specified in `options.time_zone`. The date must occur within 90 days after the value of the `date_from` parameter. | N/A |
| date\_type | string | A date type. Possible values: `created_at` is a date when a transaction is created (set by default); `paid_at` is a date when a transaction is paid; `updated_at` is a date when a transaction is updated. | N/A |
| merchant\_id | string | Merchant IDs. Submit as a string with one or more values separated with commas. | N/A |
| shop\_id | string | Shop IDs. Submit as a string with one or more values separated with commas. | N/A |
| uid | string (36) | Transaction identifier. | + |
| description | string (1024) | Transaction description. | + |
| type | string | Transaction types. Submit as a string with one or several values separated with commas. Possible values: `authorization`, `payment`, `tokenization`, `payout`, `capture`, `void`, `refund`, `credit`, `chargeback`. | N/A |
| status | string | Transaction statuses. Submit as a string of values separated with commas. Possible values: `successful`, `failed`, `incomplete`, `error`, `pending`. | N/A |
| amount | string | Transaction amount. Submit as a string with one or more big integer values, separated with commas. | N/A |
| currency | string | Transaction currency. Submit as a string with a single or multiple values separated with commas. The values must be in the [ISO-4217](http://en.wikipedia.org/wiki/ISO_4217) format, for example, `USD`. | N/A |
| test | boolean | By default, `false`. If `true`, the data on test transactions will be returned. | N/A |
| code | string (7) | Transaction result code. | N/A |
| recurring\_type | string | Submit as a string with a single or multiple values separated with commas. Possible recurring types: `recurring`, `initial`, `null`. | N/A |
| fraud | string | Fraud check result. Possible values: `reject` - the transaction was rejected, for example, if the card's BIN is in the blacklist, `review` - the transaction is under review of the PSP. | N/A |
| tracking\_id | string (500) | A transaction identifier in the merchant's system. | + |
| gateway\_id | string | Identifier(s) of payment gateway(s) enabled for the merchant's shop. Submit as a string with a single or multiple integer values separated with commas. | N/A |
| gateway\_type | string | Name(s) of payment gateway(s) enabled for the merchant's shop. Submit as a string with a single or multiple values separated with commas. | N/A |
| gateway\_agent\_id | string | Identifier(s) of merchant's agent account(s). Submit as a string with a single or multiple integer values separated with commas. | N/A |
| shop\_business\_category\_id | integer | Business category assigned to the merchant's shop. | N/A |
| provider\_raw\_rrn | string (64) | A retrieval reference number. A transaction ID issued by a card processing network. | + |
| provider\_raw\_ref\_id | string (510) | Transaction identifier in the provider's system. | + |
| customer\_id | string | Customer's ID in the PSP system. | N/A |
| customer\_ip | string (255) | The customer's IP address upon making a payment. | N/A |
| customer\_full\_name | string (255) | The customer's full name (first name, last name and patronymic). | + |
| customer\_phone | string (100) | The customer's phone number. | + |
| customer\_email | string (255) | The customer's email address. | + |
| method\_type | string | A payment method. Possible values: `credit_card` stands for card payment methods; `alternative` stands for non-card payment methods. | N/A |
| method\_alternative\_account | string (255) | Payment method attribute, for example, an account in the alternative payment method system. | N/A |
| credit\_card\_product | string (255) | A card brand or product | N/A |
| credit\_card\_first\_1 | string (1) | The first 1 digit of a credit card | N/A |
| credit\_card\_bin | string (6) | 6-digit bank identification number. | N/A |
| credit\_card\_bin\_8 | string (8) | 8-digit bank identification number. | N/A |
| credit\_card\_last\_4 | string (8) | The last 4 digits of the card number. | N/A |
| credit\_card\_holder | string (70) | A cardholder's name. | + |
| credit\_card\_brand | string (60) | A card brand. | N/A |
| credit\_card\_sub\_brand | string (60) | A card sub-brand | N/A |
| credit\_card\_stamp | string (128) | A card hash. It is constant even if the expiration date or card holder are changed. | N/A |
| credit\_card\_issuer\_country | string (2) | A country of the bank that issued the card in the [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1) format. | N/A |
| recipient\_customer\_id | string | Recipient's ID in the PSP system. | N/A |
| recipient\_customer\_ip | string (255) | The recipient's IP address upon making a payment. | N/A |
| recipient\_customer\_full\_name | string (255) | The recipient's full name (first name, last name and patronymic). | + |
| recipient\_customer\_email | string (255) | The recipient's email address. | + |
| recipient\_customer\_phone | string (100) | The recipient's phone number. | + |
| recipient\_credit\_card\_product | string (255) | A brand or product of the recipient's card. | N/A |
| recipient\_credit\_card\_first\_1 | string (1) | The first 1 digit of the recipient's card. | N/A |
| recipient\_credit\_card\_bin | string (6) | 6-digit bank identification number of the recipient's card. | N/A |
| recipient\_credit\_card\_bin\_8 | string (8) | 8-digit bank identification number of the recipient's card. | N/A |
| recipient\_credit\_card\_last\_4 | string (8) | The last 4 digits of the recipient's card number. | N/A |
| recipient\_credit\_card\_holder | string (70) | A holder's name of the recipient's card. | + |
| recipient\_credit\_card\_brand | string (60) | A brand of the recipient's card. | N/A |
| recipient\_credit\_card\_sub\_brand | string (60) | A sub-brand of the recipient's card. | N/A |
| recipient\_credit\_card\_stamp | string (128) | The hash of the recipient's card. It is constant even if the expiration date or card holder are changed. | N/A |
| recipient\_credit\_card\_issuer\_country | string (2) | The country of the bank that issued the recipient's card in the [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1) format. | N/A |

**Request example** 

`{`  
`  "filter": {`  
`    "date_from": "2024-01-01T23:19:39+02:00",`  
`    "date_to": "2024-01-02T23:19:39+02:00"`  
`  },`  
`  "options": {`  
`    "time_zone": "Europe/Vilnius"`  
`  }`  
`}`

### Response

The response contains the following parameters:

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| data | object | A section of transaction details. |
| count | integer | A number of transactions that meet the request parameters. |

**Response example** 

`{`  
`    "data": {`  
`        "count": 1251`  
`    }`  
`}`

 

- [Admin Panel User Guide](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#main-content)

    - [Introduction](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#introduction)
    - [Before you start](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#before-you-start)
    - [Users](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#users)
    - [System administration](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#system-administration)
    - [Merchant account management](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#merchant-account-management)
    - [Configuration of payment gateways](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#configuration-of-payment-gateways)
    - [Merchant shop management](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#merchant-shop-management)
    - [Dashboard](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#dashboard)
    - [Configuration of fraud protection services](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#configuration-of-fraud-protection-services)
    - [Transaction management](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#transaction-management)
    - [Subscription management](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#subscription-management)
    - [Transaction reports](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#transaction-reports)
    - [Accounting and financial reports](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#accounting-and-financial-reports)
    - [Finances](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#finances)
    - [Merchant's balance](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#merchants-balance)
    - [Mass payouts to customers](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#mass-payouts-to-customers)
    - [Additional services](https://help.ecomcharge.com/en/knowledge-base/admin-panel-user-guide?hsLang=en#additional-services)
- [Smart Risk and Routing Engine](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#main-content)

    - [Introduction](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#introduction)
    - [Overall service description](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#overall-service-description)
    - [Getting started](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#getting-started)
    - [Smart routing management](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#smart-routing-management)
    - [Settings management](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#settings-management)
    - [Appendix 1: Logical operators](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#appendix-1-logical-operators)
    - [Appendix 2: List of system fields](https://help.ecomcharge.com/en/knowledge-base/smart-risk-and-routing-engine?hsLang=en#appendix-2-list-of-system-fields)
- [PSP API documentation](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#main-content)

    - [Introduction](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#introduction)
    - [Request requirements](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#request-requirements)
    - [HTTP response codes](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#http-response-codes)
    - [PSP ID and Secret Key](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#psp-id-and-secret-key)
    - [Merchants](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#merchants)
    - [Shops](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#shops)
    - [Transactions (DWH v.2)](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#transactions-dwh-v-2)
    - [Transactions (DWH v.1)](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#transactions-dwh-v-1)
    - [Reference](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#reference)
    - [Reports (DWH v.2)](https://help.ecomcharge.com/en/knowledge-base/psp-api-documentation?hsLang=en#reports-dwh-v-2)
- [Video guides](https://help.ecomcharge.com/en/knowledge-base/video-guides?hsLang=en#main-content)

    - [Creating rules in Smart Routing](https://help.ecomcharge.com/en/knowledge-base/video-guides?hsLang=en#creating-rules-in-smart-routing)
    - [Payment Widget customization](https://help.ecomcharge.com/en/knowledge-base/video-guides?hsLang=en#payment-widget-customization)
- [Integrations](https://help.ecomcharge.com/en/knowledge-base/integrations?hsLang=en#main-content)

    - [Active Connectors with PSPs, banks, APM solution providers](https://help.ecomcharge.com/en/knowledge-base/integrations?hsLang=en#active-connectors-with-psps-banks-apm-solution-providers)
- [Release Notes](https://help.ecomcharge.com/en/knowledge-base/release-notes?hsLang=en#main-content)

    - [2025](https://help.ecomcharge.com/en/knowledge-base/release-notes?hsLang=en#2025)
- [Support and Requests](https://help.ecomcharge.com/en/knowledge-base/support-and-requests?hsLang=en)

[![eComCharge\_main logo uncut@3x 1-2](https://help.ecomcharge.com/hs-fs/hubfs/eComCharge_main%20logo%20uncut@3x%201-2.png?width=150&height=77&name=eComCharge_main%20logo%20uncut@3x%201-2.png "eComCharge_main logo uncut@3x 1-2")](https://help.ecomcharge.com/?hsLang=en)

<https://www.linkedin.com/company/ecomcharge/> [mailto:sales@ecomcharge.com](mailto:sales@ecomcharge.com)

© 2026 eComCharge UAB