> ## 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 Operation by User and ID

> Retrieves a single fiat operation of a specific 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. |
| operation_id | Path | Yes | Identifier of the fiat operation. |

#### Response

| 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/{operation_id}
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/{operation_id}:
    get:
      tags:
        - Payments
      summary: Get FIAT Operation by User and ID
      description: >-
        Retrieves a single fiat operation of a specific 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. |

        | operation_id | Path | Yes | Identifier of the fiat operation. |


        #### Response


        | 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-operation-by-user-and-id
      parameters:
        - name: user_id
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
        - name: operation_id
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                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:
                    type: string
                  cashoutErrorMessage:
                    type: string
                  operationMetadata:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        value:
                          type: string
              examples:
                fiats-operations-by-id:
                  summary: fiats/operations by id
                  value:
                    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.
                    operationMetadata:
                      - id: 3d6d89a4-a64e-413b-b559-ad3f09cf4211
                        name: cashout_error_code
                        value: '005'
                      - id: 08a607e5-bb94-4620-9eab-8ea94a124a96
                        name: cashout_error_message
                        value: >-
                          La orden 4954 se encuentra abierta, no es posible
                          crear otra. Cierre o procese la anterior.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Access token from POST /api/v1/client/token.

````