> ## Documentation Index
> Fetch the complete documentation index at: https://docs-api.kravata.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get FIAT Operations by User

> Lists the fiat operations of a single user.

#### Request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Authorization | Header | Yes | `Bearer <access_token>` obtained from **POST /api/v1/client/token**. |
| user_id | Path | Yes | Identifier of the user. |
| direction | Query | No | Filter by `PAYIN`, `PAYOUT` or `PAYMENT`. |
| status | Query | No | Filter by status (e.g. `PENDING`, `COMPLETED`). |
| paymentMethod | Query | No | Filter by rail (e.g. `PSE`). |
| page | Query | No | Page number, starting at 1. |
| pageSize | Query | No | Number of records per page. |

#### Response

Paginated responses share the same envelope: `items` (the records), `total`, `page`, `pageSize`, `orderBy` and `orderDirection`. Each item contains:

| Field | Description |
| --- | --- |
| id | Unique identifier of the fiat operation. |
| userId | User that owns the operation. |
| type | `FIAT_DEPOSIT` or `FIAT_WITHDRAWAL`. |
| direction | `PAYIN`, `PAYOUT` or `PAYMENT`. |
| currency | Fiat currency (e.g. `COP`). |
| amountOrigin / amountDestination | Amounts debited and credited. |
| originId / destinationId | Origin and destination references of the funds. |
| paymentMethod | Rail used (e.g. `PSE`, `ACH`, `BREB`). |
| status | Current status of the operation (e.g. `PENDING`, `COMPLETED`, `REJECTED`). |
| registerDate | Creation timestamp. |
| pseLink | Payment link for PSE pay-ins, when applicable. |
| transactionPurpose / externalReference | References sent when the operation was created. |
| cashoutErrorCode / cashoutErrorMessage | Provider error details when a payout fails. |



## OpenAPI

````yaml /stack/openapi.json get /api/v1/admin/fiats/{user_id}/operations
openapi: 3.1.0
info:
  title: Kravata Stack API
  version: '2.0'
  description: >-
    Kravata Stack API: users, accounts, custody wallets, liquidity ramps and
    fiat payments.
servers:
  - url: https://test-api-kore.kravata.co
    description: Test
  - url: https://partners-api.kravata.co
    description: Production (mTLS + IP allowlist)
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Users
  - name: Accounts
  - name: Earn
  - name: Custody
  - name: Liquidity Ramps
  - name: Payments
  - name: Webhooks
paths:
  /api/v1/admin/fiats/{user_id}/operations:
    get:
      tags:
        - Payments
      summary: Get FIAT Operations by User
      description: >-
        Lists the fiat operations of a single user.


        #### Request


        | Field | Type | Required | Description |

        | --- | --- | --- | --- |

        | Authorization | Header | Yes | `Bearer <access_token>` obtained from
        **POST /api/v1/client/token**. |

        | user_id | Path | Yes | Identifier of the user. |

        | direction | Query | No | Filter by `PAYIN`, `PAYOUT` or `PAYMENT`. |

        | status | Query | No | Filter by status (e.g. `PENDING`, `COMPLETED`).
        |

        | paymentMethod | Query | No | Filter by rail (e.g. `PSE`). |

        | page | Query | No | Page number, starting at 1. |

        | pageSize | Query | No | Number of records per page. |


        #### Response


        Paginated responses share the same envelope: `items` (the records),
        `total`, `page`, `pageSize`, `orderBy` and `orderDirection`. Each item
        contains:


        | Field | Description |

        | --- | --- |

        | id | Unique identifier of the fiat operation. |

        | userId | User that owns the operation. |

        | type | `FIAT_DEPOSIT` or `FIAT_WITHDRAWAL`. |

        | direction | `PAYIN`, `PAYOUT` or `PAYMENT`. |

        | currency | Fiat currency (e.g. `COP`). |

        | amountOrigin / amountDestination | Amounts debited and credited. |

        | originId / destinationId | Origin and destination references of the
        funds. |

        | paymentMethod | Rail used (e.g. `PSE`, `ACH`, `BREB`). |

        | status | Current status of the operation (e.g. `PENDING`, `COMPLETED`,
        `REJECTED`). |

        | registerDate | Creation timestamp. |

        | pseLink | Payment link for PSE pay-ins, when applicable. |

        | transactionPurpose / externalReference | References sent when the
        operation was created. |

        | cashoutErrorCode / cashoutErrorMessage | Provider error details when a
        payout fails. |
      operationId: get-fiat-operations-by-user
      parameters:
        - name: user_id
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        userId:
                          type: string
                        type:
                          type: string
                        direction:
                          type: string
                        currency:
                          type: string
                        originId: {}
                        destinationId:
                          type: string
                        amountOrigin:
                          type: integer
                        amountDestination:
                          type: integer
                        paymentMethod:
                          type: string
                        status:
                          type: string
                        registerDate:
                          type: string
                        pseLink: {}
                        paymentAccountExternalId: {}
                        paymentDestinationAccountExternalId: {}
                        transactionPurpose: {}
                        cashoutErrorCode: {}
                        cashoutErrorMessage: {}
                  total:
                    type: integer
                  page: {}
                  pageSize: {}
                  orderBy: {}
                  orderDirection: {}
              examples:
                fiats-operations-by-user:
                  summary: fiats/operations by user
                  value:
                    items:
                      - id: a7620fad-a7de-4fa6-ac4b-c217a29f1321
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_DEPOSIT
                        direction: PAYIN
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 100000
                        amountDestination: 100000
                        paymentMethod: PSE
                        status: PENDING
                        registerDate: '2026-07-10T14:31:29.247323'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: bd63222b-26cb-41f8-bffc-8499c5583304
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_DEPOSIT
                        direction: PAYIN
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 100000
                        amountDestination: 100000
                        paymentMethod: PSE
                        status: PENDING
                        registerDate: '2026-07-10T16:00:37.497712'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: e5e2e1f9-8590-4a84-9022-e18340eab4e3
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_PAYMENT
                        direction: PAYMENT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 400000
                        amountDestination: 400000
                        paymentMethod: PSE
                        status: PENDING
                        registerDate: '2026-07-14T14:06:54.452580'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: Cuota mensual
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: 3cca8a02-0c3b-41a1-9c7a-a6a00218534c
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_PAYMENT
                        direction: PAYMENT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 400000
                        amountDestination: 400000
                        paymentMethod: PSE
                        status: PENDING
                        registerDate: '2026-07-14T14:12:00.232964'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: Cuota mensual
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: 1564b4f5-0e9c-4a91-a9f0-d8b020d1bbdf
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_DEPOSIT
                        direction: PAYIN
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 100000
                        amountDestination: 100000
                        paymentMethod: PSE
                        status: COMPLETED
                        registerDate: '2026-07-12T17:10:29.499251'
                        pseLink: >-
                          https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=mynzC%2byfBLkFA1W%2bQFsxYYVk00J6%2f%2f%2fji1G3099Fhpg%3d
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: f5182c8c-b801-4970-b50a-d757699d0811
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_DEPOSIT
                        direction: PAYIN
                        currency: COP
                        originId: null
                        destinationId: null
                        amountOrigin: 100000
                        amountDestination: 100000
                        paymentMethod: PSE
                        status: COMPLETED
                        registerDate: '2026-07-14T13:20:14.125101'
                        pseLink: >-
                          https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=oTohrIA7FKlObtSaDi3V%2fL1ySRm7a2ZI1JTypyGDO8k%3d
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: fb5a1ead-23bb-43de-8619-543675cbd9a2
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_DEPOSIT
                        direction: PAYIN
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 100000
                        amountDestination: 100000
                        paymentMethod: PSE
                        status: CASHINREJECTED
                        registerDate: '2026-07-12T16:58:08.787684'
                        pseLink: >-
                          https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=mynzC%2byfBLkFA1W%2bQFsxYUCsCtMscspAMz%2fPm8aexCI%3d
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: 8a9f6fa0-e9b3-4a2d-9b76-e57995c188b9
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_DEPOSIT
                        direction: PAYIN
                        currency: COP
                        originId: null
                        destinationId: null
                        amountOrigin: 100000
                        amountDestination: 100000
                        paymentMethod: PSE
                        status: CASHINREJECTED
                        registerDate: '2026-07-14T13:24:52.891347'
                        pseLink: >-
                          https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=oTohrIA7FKlObtSaDi3V%2fIYDjAmnNvezWu3TSBusDjk%3d
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: e2ad2552-2928-4044-91aa-9677e1431874
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 50000
                        amountDestination: 50000
                        paymentMethod: PSE
                        status: CASHOUTINIT
                        registerDate: '2026-07-13T17:06:27.724176'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: null
                        cashoutErrorMessage: null
                      - id: 39252943-8173-4e7c-909c-25edfe583255
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 50000
                        amountDestination: 50000
                        paymentMethod: PSE
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-13T16:48:04.850634'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: 381fd0b8-7ccd-4b40-940b-0a454e827bd7
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 50000
                        amountDestination: 50000
                        paymentMethod: PSE
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T11:03:35.854204'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: 6d9541d3-8f0e-4d99-82c3-f435d2937a19
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 10000
                        amountDestination: 10000
                        paymentMethod: PSE
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T11:05:41.178253'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: beb84ece-0313-42ca-8d70-e908dffac07a
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 10000
                        amountDestination: 10000
                        paymentMethod: PSE
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T11:06:12.907402'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: b1e41d4a-4a0c-461a-8ddd-0e823df550db
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 5000
                        amountDestination: 5000
                        paymentMethod: PSE
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T13:26:27.174873'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: 9f36a8d0-2eef-47bf-879e-fe4d84314407
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 5000
                        amountDestination: 5000
                        paymentMethod: PSE
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T13:27:18.458325'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: 9f7256a7-d18b-4a82-890b-64f2005fc096
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 5000
                        amountDestination: 5000
                        paymentMethod: PSE
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T13:46:18.336615'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: 8d34e264-ccc8-44ef-8ea0-aa3af7ec4be5
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 5000
                        amountDestination: 5000
                        paymentMethod: ACH
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T13:51:35.556187'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                      - id: 7572569e-4628-43ed-bb14-3479d2efbc8f
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        type: FIAT_WITHDRAWAL
                        direction: PAYOUT
                        currency: COP
                        originId: null
                        destinationId: 07587d1d-2df0-4043-b6a0-6f974ea4d533
                        amountOrigin: 5000
                        amountDestination: 5000
                        paymentMethod: ACH
                        status: CASHOUTREJECTED
                        registerDate: '2026-07-14T14:11:35.024664'
                        pseLink: null
                        paymentAccountExternalId: null
                        paymentDestinationAccountExternalId: null
                        transactionPurpose: null
                        cashoutErrorCode: '005'
                        cashoutErrorMessage: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
                    total: 18
                    page: null
                    pageSize: null
                    orderBy: null
                    orderDirection: null
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Access token from POST /api/v1/client/token.

````