---
title: Export transactions by uid
description: api
---

[Skip to content](https://help.ecomcharge.com/en/knowledge-base/api-export-transactions-by-uid#main-content)

- [English](https://help.ecomcharge.com/en/knowledge-base/api-export-transactions-by-uid)
- [Русский](https://help.ecomcharge.com/knowledge-base-ru/api-export-transactions-by-uid)

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-export-transactions-by-uid)
    - [Русский](https://help.ecomcharge.com/knowledge-base-ru/api-export-transactions-by-uid)

  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)

# Export transactions by uid

This endpoint lets you export the data on the transactions by specifying their identifiers (`uid`) in the request. Unlike the other transaction export endpoints, this one doesn't require a date filter in the request. The maximum number of identifiers in the request – 100. The method retrieves transactions created in the system in 2022 or later.

### 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/uids_export` with the following parameters:

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| response\_parameters | string | A string of transaction parameters that need to be sent in the response. Format example: `"response_parameters": "main,shop,gateway"` Each value stands for a group of attributes. If the parameter is not sent, the parameters of `main` group will be sent in the request. If the parameter is sent but `main` is not specified in `response_parameters` – `status`, `type` and `uid` will be returned. See more about the parameter groups [here](https://psp-doc.begateway.com/en/psp_transactions_v2/export/#response-attribute-groups). |
| filter | object |  |
| uids | array of strings | Array of transaction identifiers in the PSP system. The maximum number of strings is 100. The array must not contain the values that do not correspond to uuid (36) format. |

**Request example**

```
{  "response_parameters": "main,gateway",  "filter": {    "uids": [      "d97b0a06-2b0b-4a97-80d2-0d5eacc63b1a",      "73885630-84f2-4b20-847c-e2b41d2e417e"    ]  }}
```

### Response

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| data | array | Array of objects where each object corresponds to the transaction found by the uid submitted in the request. The transactions will be sorted based on the `created_at` parameter value starting from the earliest created transaction. The transaction data sent in the response will depend on the `response_parameters` groups specified in the request. See the description of the response parameter groups [here](https://psp-doc.begateway.com/en/psp_transactions_v2/export/#response-attribute-groups). |

**Response example**

```
{  "data": [    {      "amount": 202,      "closed_at": null,      "code": "S.0000",      "created_at": "2024-11-26T08:43:54.242000Z",      "currency": "EUR",      "description": "Test transaction",      "expired_at": null,      "fraud": "",      "friendly_message": "The transaction is successfully processed.",      "gateway": {        "agent_id": null,        "connection_type": "",        "id": 4571,        "note": "",        "type": "Demo",        "vendor": "gateway"      },      "language": "en",      "manually_corrected_at": null,      "merchant_id": 60,      "message": "Successfully processed",      "paid_at": "2024-11-26T08:43:55.725000Z",      "parent_uid": null,      "product_id": null,      "psp_settled_at": null,      "reason": null,      "recurring_type": null,      "settled_at": null,      "shop_id": 1523,      "status": "successful",      "subscription_id": null,      "test": false,      "tracking_id": "123-456",      "type": "payment",      "uid": "73885630-84f2-4b20-847c-e2b41d2e417e",      "updated_at": "2024-11-26T08:43:55.783000Z"    },    {      "amount": 1500,      "closed_at": null,      "code": "S.0000",      "created_at": "2025-05-21T05:45:12.491000Z",      "currency": "USD",      "description": "Subscribtion plan",      "expired_at": null,      "fraud": "",      "friendly_message": "The transaction is successfully processed.",      "gateway": {        "agent_id": null,        "connection_type": "",        "id": 5079,        "note": "",        "type": "Bogus",        "vendor": "gateway"      },      "language": "ru",      "manually_corrected_at": null,      "merchant_id": 1364,      "message": "Successfully processed",      "paid_at": "2025-05-21T05:45:20.652000Z",      "parent_uid": null,      "product_id": null,      "psp_settled_at": null,      "reason": null,      "recurring_type": "recurring",      "settled_at": null,      "shop_id": 2091,      "status": "successful",      "subscription_id": null,      "test": true,      "tracking_id": null,      "type": "payment",      "uid": "d97b0a06-2b0b-4a97-80d2-0d5eacc63b1a",      "updated_at": "2025-05-21T05:45:21.004000Z"    }  ]}
```

 

- [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