Get a transaction

GET /companies/{company_id}/transactions/{transaction_id}

Retrieve a specific transaction by its unique identifier.

Path parameters

  • company_id string Required

    The Company ID given by Fipto.

    Format should match the following pattern: [0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}.

  • transaction_id string Required

    The Transaction ID given by Fipto.

    Format should match the following pattern: [0-9a-zA-Z]{22}.

Responses

  • 200

    Retrieve a transaction

    Hide response attributes Show response attributes object
    • meta object Required
      Hide meta attributes Show meta attributes object
      • request_id string Required

        Unique identifier generated by the server.

        Format should match the following pattern: [0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}.

      • query_parameters object

        Information about the parameters in the request. All query string parameters provided (or implicit/with default value) will be returned

    • data object

      One of:
      payin_data object payout_data object

      Fields required on all objects.

      Hide attributes Show attributes
      • type string Required

        Value is payin.

      • attributes object Required
        Hide attributes attributes Show attributes attributes object
        • wallet object

          Wallet information in a transaction

          Hide wallet attributes Show wallet attributes object
          • wallet_id string Required

            Unique identifier generated by Fipto product on base62 format.

            Format should match the following pattern: [0-9a-zA-Z]{22}.

          • wallet_name string Required

            The name of the wallet.

        • amount string

          Strictly positive amount expressed in the currency of the transaction.

          Format should match the following pattern: ^(0*[1-9]\d*(\.\d+)?|0*\.\d*[1-9]\d*)$.

        • valuations array[object]

          Valuation of an asset

          Hide valuations attributes Show valuations attributes array[object]
          • asset string

            The quote asset of the provided valuation.

            Values are EUR or USD.

          • value string

            The estimated value of the asset (based on the quote asset).

        • booked_at string(date-time)

          The specific date on which the transaction has been booked.

        • valued_at string(date-time)

          The specific date on which the transaction has been valued.

        • created_at string(date-time)

          The specific date on which the transaction has been created.

        • source string

          The external wallet address that initiated the payment.

        • wallet_details object

          Minimal info in common about Wallet Details

          Hide wallet_details attributes Show wallet_details attributes object
          • asset string Required

            The symbol/ticker of the crypto asset.

            Format should match the following pattern: ([A-Z_]){3,}.

          • address string Required

            The public address associated with a wallet details on the blockchain.

          • name string

            The wallet details name

          • tag string
        • status string

          Status of the payin.

          Values are in transit, completed, or returned.

        • transaction_id string

          Unique identifier generated by Fipto product on base62 format.

          Format should match the following pattern: [0-9a-zA-Z]{22}.

        • blockchain_data object

          Data from the blockchain

          Hide blockchain_data attributes Show blockchain_data attributes object
      • id string

        Unique identifier generated by Fipto product on base62 format.

        Format should match the following pattern: [0-9a-zA-Z]{22}.
GET /companies/{company_id}/transactions/{transaction_id} 
curl \
 -X GET https://api.fipto.app/companies/9de0691c-bc8d-409b-8f40-75d4f45db2f3/transactions/3Qv67yjXEwB9SjmvkuG6Cp
Response examples (200) 
{
  "meta": {
    "request_id": "string",
    "query_parameters": {}
  },
  "data": {
    "type": "payin",
    "attributes": {
      "wallet": {
        "wallet_id": "string",
        "wallet_name": "My wallet"
      },
      "amount": "1000",
      "valuations": [
        {
          "asset": "EUR",
          "value": "10.05"
        },
        {
          "asset": "USD",
          "value": "12.97"
        }
      ],
      "booked_at": "2023-05-04T09:42:00+00:00",
      "valued_at": "2023-05-04T09:42:00+00:00",
      "created_at": "2023-05-04T09:42:00+00:00",
      "source": "string",
      "wallet_details": {
        "asset": "BTC",
        "address": "0x71C*",
        "name": "Acme - Payment Project X",
        "tag": "string"
      },
      "status": "returned",
      "transaction_id": "string",
      "blockchain_data": {
        "transaction_hash": "string",
        "block_explorer_link": "string"
      }
    },
    "id": "string"
  }
}
Response examples (200) 
{
  "meta": {
    "request_id": "string",
    "query_parameters": {}
  },
  "data": {
    "type": "payin",
    "attributes": {
      "wallet": {
        "wallet_id": "string",
        "wallet_name": "My wallet"
      },
      "amount": "1000",
      "valuations": [
        {
          "asset": "EUR",
          "value": "10.05"
        },
        {
          "asset": "USD",
          "value": "12.97"
        }
      ],
      "booked_at": "2025-05-04T09:42:00Z",
      "valued_at": "2025-05-04T09:42:00Z",
      "created_at": "2025-05-04T09:42:00Z",
      "source": "string",
      "wallet_details": {
        "asset": "BTC",
        "address": "0x71C*",
        "name": "Acme - Payment Project X",
        "tag": "string"
      },
      "status": "returned",
      "transaction_id": "string",
      "blockchain_data": {
        "transaction_hash": "string",
        "block_explorer_link": "string"
      }
    },
    "id": "string"
  }
}