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 with your PSP ID and 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.
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.

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"
    }
  ]
}