Get transactions

GET /companies/{company_id}/transactions

Retrieve the list of all transactions in your company, with the ability to apply filters based on the wallet, transaction type, and pagination.

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}.

Query parameters

  • The page number retrieved in the paginated results. The default value is 1.

  • The number of items to include in each page of the paginated results. The default value is 100.

  • sort string

    The sort field used to filter data.

    Values are created_at, amount, or status. Default value is created_at.

  • transaction_types array[string]

    Filter for specific transaction types.

    Values are payin, payout, or fee.

  • Filter for a specific wallet_id.

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

Responses

  • Retrieve list of transactions

    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}.

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

    • data array[object]

      One of:

      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.

        • 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.

        • Unique identifier generated by Fipto product on base62 format.

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

        • 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
curl \
 -X GET https://api.fipto.app/companies/9de0691c-bc8d-409b-8f40-75d4f45db2f3/transactions
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"
    }
  ]
}