Transactions

STAGING_URL: https://switchapi3.azurewebsites.net
LIVE_URL: https://switchapi.azurewebsites.net

Get Transactions

GET https://switchapi3.azurewebsites.net/user/transactions

This endpoint gets a user's transactions.

Query Parameters

Name	Type	Description
platform	string	wallet, account or dom_account.
page	string	Defaults to 1.
per_page	string	Defaults to 20.
transaction_type	string	credit or debit
initiator	string	One of the following: - wallet_transfer - account_transfer - service_payment - wallet_funding - account_funding - bill_payment - opening_balance - account_transfer_charge
start_date	string	Format is YYYY-MM-DD
end_date	string	Format is YYYY-MM-DD

Headers

Name	Type	Description
Authorization	string	Format for Authorization is Bearer token

200

{
  "message": "Transactions retrieved successfully",
  "data": [
    {
      "id": "2253",
      "transaction_type": "debit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4278497",
      "new_balance_kobo": "4178497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": true,
        "sender": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        },
        "recipient": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        }
      }
    },
    {
      "id": "2251",
      "transaction_type": "debit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4378497",
      "new_balance_kobo": "4278497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": true,
        "sender": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        },
        "recipient": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        }
      }
    },
    {
      "id": "2240",
      "transaction_type": "debit",
      "amount_kobo": 500000,
      "fee": "0.0",
      "total_kobo": 500000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4878497",
      "new_balance_kobo": "4378497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": true,
        "sender": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        },
        "recipient": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        }
      }
    },
    {
      "id": "2239",
      "transaction_type": "credit",
      "amount_kobo": 200000,
      "fee": "0",
      "total_kobo": 200000,
      "initiator": "wallet_funding",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4678497",
      "new_balance_kobo": "4878497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "reference": "63aa22b2-5e2c-47be-873b-paystack-ab568369bdbf",
        "payment_type": "card",
        "payment_processor": "paystack",
        "currency": "NGN"
      }
    },
    {
      "id": "2238",
      "transaction_type": "credit",
      "amount_kobo": 200000,
      "fee": "0",
      "total_kobo": 200000,
      "initiator": "wallet_funding",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4478497",
      "new_balance_kobo": "4678497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "reference": "55b435d5-737e-4e46-8b6e-paystack-112efca1bf0e",
        "payment_type": "card",
        "payment_processor": "paystack",
        "currency": "NGN"
      }
    },
    {
      "id": "2237",
      "transaction_type": "credit",
      "amount_kobo": 200000,
      "fee": "0",
      "total_kobo": 200000,
      "initiator": "wallet_funding",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4278497",
      "new_balance_kobo": "4478497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "reference": "e72bfaa1-41c3-4b8f-9424-paystack-00cdcb53557c",
        "payment_type": "card",
        "payment_processor": "paystack",
        "currency": "NGN"
      }
    },
    {
      "id": "2230",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4178497",
      "new_balance_kobo": "4278497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2228",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "4078497",
      "new_balance_kobo": "4178497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2226",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3978497",
      "new_balance_kobo": "4078497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2224",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3878497",
      "new_balance_kobo": "3978497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2222",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3778497",
      "new_balance_kobo": "3878497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2220",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3678497",
      "new_balance_kobo": "3778497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2218",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3578497",
      "new_balance_kobo": "3678497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2216",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3478497",
      "new_balance_kobo": "3578497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2214",
      "transaction_type": "credit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3378497",
      "new_balance_kobo": "3478497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": false,
        "sender": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        },
        "recipient": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        }
      }
    },
    {
      "id": "2211",
      "transaction_type": "debit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3478497",
      "new_balance_kobo": "3378497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": true,
        "sender": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        },
        "recipient": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        }
      }
    },
    {
      "id": "2209",
      "transaction_type": "debit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3578497",
      "new_balance_kobo": "3478497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": true,
        "sender": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        },
        "recipient": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        }
      }
    },
    {
      "id": "2207",
      "transaction_type": "debit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3678497",
      "new_balance_kobo": "3578497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": true,
        "sender": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        },
        "recipient": {
          "full_name": "Demilade Omitiran",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_Screenshot 2019-05-07 at 4.00.10 PM.png"
        }
      }
    },
    {
      "id": "2205",
      "transaction_type": "debit",
      "amount_kobo": 100000,
      "fee": "0.0",
      "total_kobo": 100000,
      "initiator": "wallet_transfer",
      "currency": "NGN",
      "status": "success",
      "previous_balance_kobo": "3778497",
      "new_balance_kobo": "3678497",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "is_sender": true,
        "sender": {
          "full_name": "Beyonce Knowles",
          "email": "[e-mail]",
          "image_selfie_url": "[phone]_image_selfie_url_beyonce.jpg"
        },
        "recipient": {
          "full_name": "Marvin Ogah",
          "email": "[e-mail]",
          "image_selfie_url": null
        }
      }
    },
    {
      "id": "2194",
      "transaction_type": "credit",
      "amount_kobo": 713100,
      "fee": "0",
      "total_kobo": 713100,
      "initiator": "wallet_funding",
      "currency": "NGN",
      "status": "pending",
      "user": {
        "id": "11",
        "first_name": "Beyonce",
        "last_name": "Knowles",
        "email": "[e-mail]",
        "is_verified": false,
        "switch_id": 100111
      },
      "transaction": {
        "reference": "630070014787603708600001500",
        "payment_type": "cash",
        "payment_processor": "pipit",
        "currency": "GBP",
        "barcode_url": "https://servers.pip-it.net/os/mgr/order/630070014787603708600001500/barcode.png"
      }
    }
  ],
  "meta": {
    "total": 99,
    "per_page": 20,
    "page": 1,
    "page_count": 5
  }
}