# Admin/Transactions

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

## Get transactions list

<mark style="color:blue;">`GET`</mark> `https://switchapi3.azurewebsites.net/admin/transactions`

Retrieves the list of all transactions.

#### Query Parameters

| Name              | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| search\_query     | string | Query using the user's email or name                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| page              | string | Defaults to 1                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| per\_page         | string | Defaults to 20                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| start\_date       | string | Must be in the format **YYYY-MM-DD**                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| end\_date         | string | Must be in the format **YYYY-MM-DD**                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| initiator         | string | <p>The transaction initiator. Must be one of the following:<br>- <em><strong>wallet\_transfer</strong></em><br>- <em><strong>service\_payment</strong></em><br>- <em><strong>wallet\_funding</strong></em><br>- <em><strong>bill\_payment</strong></em><br>- <em><strong>opening\_balance</strong></em><br>- <em><strong>account\_funding</strong></em><br>- <em><strong>account\_transfer</strong></em><br>- <em><strong>account\_transfer\_charge</strong></em></p> |
| transaction\_type | string | ***debit*** or ***credit***                                                                                                                                                                                                                                                                                                                                                                                                                                           |

#### Headers

| Name          | Type   | Description                  |
| ------------- | ------ | ---------------------------- |
| SWI-CID       | string | Client ID                    |
| Authorization | string | Format is ***Bearer token*** |

{% tabs %}
{% tab title="200 " %}

```
{
    "message": "Transactions retrieved successfully",
    "data": [
        {
            "id": 921,
            "amount_kobo": 5410200,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 5410200,
            "transaction_type": "credit",
            "created_at": "2019-05-21T17:42:21.250Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "reference": "630070017607023272200012050",
                "currency": "GBP",
                "payment_processor": "pipit",
                "payment_type": "cash",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Demilade",
                "last_name": "Omitiran",
                "email": "omitirand@gmail.com",
                "is_verified": false,
                "switch_id": 100199
            }
        },
        {
            "id": 920,
            "amount_kobo": 710000,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 710000,
            "transaction_type": "credit",
            "created_at": "2019-05-21T16:20:22.355Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "reference": "630070017135498993100002050",
                "currency": "USD",
                "payment_processor": "pipit",
                "payment_type": "cash",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Demilade",
                "last_name": "Omitiran",
                "email": "omitirand@gmail.com",
                "is_verified": false,
                "switch_id": 100199
            }
        },
        {
            "id": 919,
            "amount_kobo": 710000,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 710000,
            "transaction_type": "credit",
            "created_at": "2019-05-21T16:20:14.058Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "reference": "630070014649709284300002050",
                "currency": "USD",
                "payment_processor": "pipit",
                "payment_type": "cash",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Demilade",
                "last_name": "Omitiran",
                "email": "omitirand@gmail.com",
                "is_verified": false,
                "switch_id": 100199
            }
        },
        {
            "id": 918,
            "amount_kobo": 710000,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 710000,
            "transaction_type": "credit",
            "created_at": "2019-05-21T16:16:36.495Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "reference": "d5ce47e9d96297c8a908-pipit-9470dd",
                "currency": "USD",
                "payment_processor": "pipit",
                "payment_type": "cash",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Demilade",
                "last_name": "Omitiran",
                "email": "omitirand@gmail.com",
                "is_verified": false,
                "switch_id": 100199
            }
        },
        {
            "id": 917,
            "amount_kobo": 500000,
            "initiator": "account_funding",
            "fee": "0.0",
            "total_kobo": 500000,
            "transaction_type": "credit",
            "created_at": "2019-05-17T20:24:06.523Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "reference": "7a62d4a9-4890-4d78-b310-bf6fd6eee85e-paystack-2a5e2c",
                "currency": "NGN",
                "payment_processor": "paystack",
                "payment_type": "card",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Sidikat",
                "last_name": "Tyson",
                "email": "mobolaakadiri@gmail.com",
                "is_verified": true,
                "switch_id": 100247
            }
        },
        {
            "id": 916,
            "amount_kobo": 100000,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 100000,
            "transaction_type": "credit",
            "created_at": "2019-05-17T20:06:09.332Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "reference": "73bbb1a7-a1e7-43ee-b988-0884140e1950-paystack-5d864e",
                "currency": "NGN",
                "payment_processor": "paystack",
                "payment_type": "card",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Olamide",
                "last_name": "Akinnagbe",
                "email": "olamidejames007@gmail.com",
                "is_verified": false,
                "switch_id": 100103
            }
        },
        {
            "id": 915,
            "amount_kobo": 500000,
            "initiator": "account_transfer",
            "fee": "0.0",
            "total_kobo": 500000,
            "transaction_type": "debit",
            "created_at": "2019-05-16T17:11:42.151Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": true,
                "sender": {
                    "full_name": "Sidikat Tyson",
                    "email": "mobolaakadiri@gmail.com",
                    "image_selfie_url": "+2348023438607_image_selfie_url_me.jpg"
                },
                "recipient": {
                    "id": 82,
                    "full_name": "SIDIKAT BOLANLE TYSON",
                    "email": null,
                    "account_number": "0008337040",
                    "bank_code": "232",
                    "image_selfie_url": null
                },
                "full_name": "SIDIKAT BOLANLE TYSON (Transfer Outward)",
                "photo_url": null
            },
            "user": {
                "first_name": "Sidikat",
                "last_name": "Tyson",
                "email": "mobolaakadiri@gmail.com",
                "is_verified": true,
                "switch_id": 100247
            }
        },
        {
            "id": 914,
            "amount_kobo": 500000,
            "initiator": "account_transfer",
            "fee": "0.0",
            "total_kobo": 500000,
            "transaction_type": "debit",
            "created_at": "2019-05-16T17:06:58.744Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": true,
                "sender": {
                    "full_name": "Sidikat Tyson",
                    "email": "mobolaakadiri@gmail.com",
                    "image_selfie_url": "+2348023438607_image_selfie_url_me.jpg"
                },
                "recipient": {
                    "id": 81,
                    "full_name": "ARIKEUKO,AZEEZ OLUWAFEMI",
                    "email": null,
                    "account_number": "0004498938",
                    "bank_code": "058",
                    "image_selfie_url": null
                },
                "full_name": "ARIKEUKO,AZEEZ OLUWAFEMI (Transfer Outward)",
                "photo_url": null
            },
            "user": {
                "first_name": "Sidikat",
                "last_name": "Tyson",
                "email": "mobolaakadiri@gmail.com",
                "is_verified": true,
                "switch_id": 100247
            }
        },
        {
            "id": 913,
            "amount_kobo": 188400,
            "initiator": "bill_payment",
            "fee": "0.0",
            "total_kobo": 188400,
            "transaction_type": "debit",
            "created_at": "2019-05-16T14:25:35.178Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "category_description": "Pay for your cable TV subscriptions here",
                "category_name": "Cable TV Bills",
                "consumer_id_field": "200900",
                "plan_name": "Access",
                "switch_short_name": null,
                "switch_category": "pay_tv_bills",
                "full_name": "Cable TV Bills (Access plan)",
                "photo_url": "https://storage.googleapis.com/switch/Bill_Logos/DSTV_logo.png"
            },
            "user": {
                "first_name": "Kayode",
                "last_name": "Balogun",
                "email": "kayoderock@gmail.com",
                "is_verified": false,
                "switch_id": 100269
            }
        },
        {
            "id": 912,
            "amount_kobo": 20000,
            "initiator": "bill_payment",
            "fee": "0.0",
            "total_kobo": 20000,
            "transaction_type": "debit",
            "created_at": "2019-05-16T14:23:51.986Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "category_description": "Recharge your phone",
                "category_name": "Mobile Recharge",
                "consumer_id_field": "08163580180",
                "plan_name": "MTN 200",
                "switch_short_name": null,
                "switch_category": "purchase_airtime",
                "full_name": "Mobile Recharge (MTN 200 plan)",
                "photo_url": "https://storage.googleapis.com/switch/Bill_Logos/Mtn_logo.png"
            },
            "user": {
                "first_name": "Kayode",
                "last_name": "Balogun",
                "email": "kayoderock@gmail.com",
                "is_verified": false,
                "switch_id": 100269
            }
        },
        {
            "id": 911,
            "amount_kobo": 20000,
            "initiator": "bill_payment",
            "fee": "0.0",
            "total_kobo": 20000,
            "transaction_type": "debit",
            "created_at": "2019-05-16T14:23:42.701Z",
            "currency": "NGN",
            "status": "pending",
            "transaction": {
                "category_description": "Recharge your phone",
                "category_name": "Mobile Recharge",
                "consumer_id_field": "08163580180",
                "plan_name": "MTN 200",
                "switch_short_name": null,
                "switch_category": "purchase_airtime",
                "full_name": "Mobile Recharge (MTN 200 plan)",
                "photo_url": "https://storage.googleapis.com/switch/Bill_Logos/Mtn_logo.png"
            },
            "user": {
                "first_name": "Kayode",
                "last_name": "Balogun",
                "email": "kayoderock@gmail.com",
                "is_verified": false,
                "switch_id": 100269
            }
        },
        {
            "id": 910,
            "amount_kobo": 500000,
            "initiator": "wallet_transfer",
            "fee": "0.0",
            "total_kobo": 500000,
            "transaction_type": "credit",
            "created_at": "2019-05-15T17:28:27.638Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": false,
                "sender": {
                    "full_name": "Surat Jimoh",
                    "email": "jimohsurat9@gmail.com",
                    "image_selfie_url": "+12162111155_image_selfie_url_SWITCH.jpg"
                },
                "recipient": {
                    "full_name": "Bolanle Tyson",
                    "email": "mobolatyson@gmail.com",
                    "image_selfie_url": "+2348028436492_selfie_PP - BOLA0001.jpg"
                },
                "full_name": "Surat Jimoh (Transfer Inward)",
                "photo_url": "https://switchfilestorage.blob.core.windows.net/switchcontainer/+12162111155_image_selfie_url_SWITCH.jpg"
            },
            "user": {
                "first_name": "Bolanle",
                "last_name": "Tyson",
                "email": "mobolatyson@gmail.com",
                "is_verified": true,
                "switch_id": 100122
            }
        },
        {
            "id": 909,
            "amount_kobo": 500000,
            "initiator": "wallet_transfer",
            "fee": "0.0",
            "total_kobo": 500000,
            "transaction_type": "debit",
            "created_at": "2019-05-15T17:28:27.628Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": true,
                "sender": {
                    "full_name": "Surat Jimoh",
                    "email": "jimohsurat9@gmail.com",
                    "image_selfie_url": "+12162111155_image_selfie_url_SWITCH.jpg"
                },
                "recipient": {
                    "full_name": "Bolanle Tyson",
                    "email": "mobolatyson@gmail.com",
                    "image_selfie_url": "+2348028436492_selfie_PP - BOLA0001.jpg"
                },
                "full_name": "Bolanle Tyson (Transfer Outward)",
                "photo_url": "+2348028436492_selfie_PP - BOLA0001.jpg"
            },
            "user": {
                "first_name": "Surat",
                "last_name": "Jimoh",
                "email": "jimohsurat9@gmail.com",
                "is_verified": true,
                "switch_id": 100355
            }
        },
        {
            "id": 908,
            "amount_kobo": 100000,
            "initiator": "wallet_transfer",
            "fee": "0.0",
            "total_kobo": 100000,
            "transaction_type": "credit",
            "created_at": "2019-05-15T14:16:56.700Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": false,
                "sender": {
                    "full_name": "Temitope Alarape",
                    "email": "talarapet@gmail.com",
                    "image_selfie_url": "+2348146816230_selfie_1536531031808.jpg"
                },
                "recipient": {
                    "full_name": "Bolanle Tyson",
                    "email": "mobolatyson@gmail.com",
                    "image_selfie_url": "+2348028436492_selfie_PP - BOLA0001.jpg"
                },
                "full_name": "Temitope Alarape (Transfer Inward)",
                "photo_url": "https://switchfilestorage.blob.core.windows.net/switchcontainer/+2348146816230_selfie_1536531031808.jpg"
            },
            "user": {
                "first_name": "Bolanle",
                "last_name": "Tyson",
                "email": "mobolatyson@gmail.com",
                "is_verified": true,
                "switch_id": 100122
            }
        },
        {
            "id": 907,
            "amount_kobo": 100000,
            "initiator": "wallet_transfer",
            "fee": "0.0",
            "total_kobo": 100000,
            "transaction_type": "debit",
            "created_at": "2019-05-15T14:16:56.689Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": true,
                "sender": {
                    "full_name": "Temitope Alarape",
                    "email": "talarapet@gmail.com",
                    "image_selfie_url": "+2348146816230_selfie_1536531031808.jpg"
                },
                "recipient": {
                    "full_name": "Bolanle Tyson",
                    "email": "mobolatyson@gmail.com",
                    "image_selfie_url": "+2348028436492_selfie_PP - BOLA0001.jpg"
                },
                "full_name": "Bolanle Tyson (Transfer Outward)",
                "photo_url": "+2348028436492_selfie_PP - BOLA0001.jpg"
            },
            "user": {
                "first_name": "Temitope",
                "last_name": "Alarape",
                "email": "talarapet@gmail.com",
                "is_verified": false,
                "switch_id": 100104
            }
        },
        {
            "id": 906,
            "amount_kobo": 300000,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 300000,
            "transaction_type": "credit",
            "created_at": "2019-05-15T13:35:19.561Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "reference": "56d7c2f1-95c8-412e-a260-0c2c64cf0694-paystack-7a01ea",
                "currency": "NGN",
                "payment_processor": "paystack",
                "payment_type": "card",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Demilade",
                "last_name": "Omitiran",
                "email": "omitirand@gmail.com",
                "is_verified": false,
                "switch_id": 100199
            }
        },
        {
            "id": 905,
            "amount_kobo": 100000,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 100000,
            "transaction_type": "credit",
            "created_at": "2019-05-15T13:27:52.794Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "reference": "84b12634-a5df-4e93-b9ca-59b1dd456cf0-paystack-41d4b9",
                "currency": "NGN",
                "payment_processor": "paystack",
                "payment_type": "card",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Olamide",
                "last_name": "Akinnagbe",
                "email": "olamidejames007@gmail.com",
                "is_verified": false,
                "switch_id": 100103
            }
        },
        {
            "id": 904,
            "amount_kobo": 110000,
            "initiator": "wallet_funding",
            "fee": "0.0",
            "total_kobo": 110000,
            "transaction_type": "credit",
            "created_at": "2019-05-15T13:22:31.439Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "reference": "f8f95853-41a6-4f33-8a9d-1bee3a74ab58-paystack-f540b6",
                "currency": "NGN",
                "payment_processor": "paystack",
                "payment_type": "card",
                "full_name": "Account funding",
                "photo_url": null
            },
            "user": {
                "first_name": "Kayode",
                "last_name": "Balogun",
                "email": "kayoderock@gmail.com",
                "is_verified": false,
                "switch_id": 100269
            }
        },
        {
            "id": 903,
            "amount_kobo": 90000,
            "initiator": "wallet_transfer",
            "fee": "0.0",
            "total_kobo": 90000,
            "transaction_type": "credit",
            "created_at": "2019-05-14T10:19:11.459Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": false,
                "sender": {
                    "full_name": "Opemipo Bolaji",
                    "email": "bolajipemipo@gmail.com",
                    "image_selfie_url": "+23408124951038_image_selfie_url_+23408124951038_image_selfie_url_TD3GS8Y7J-UD4B8TB6W-49bd9443e918-512.jpg"
                },
                "recipient": {
                    "full_name": "Olaoluwa Oluro",
                    "email": "ollaollu@gmail.com",
                    "image_selfie_url": "+2348092417972_image_selfie_url_IMG_2026.jpg"
                },
                "full_name": "Opemipo Bolaji (Transfer Inward)",
                "photo_url": "https://switchfilestorage.blob.core.windows.net/switchcontainer/+23408124951038_image_selfie_url_+23408124951038_image_selfie_url_TD3GS8Y7J-UD4B8TB6W-49bd9443e918-512.jpg"
            },
            "user": {
                "first_name": "Olaoluwa",
                "last_name": "Oluro",
                "email": "ollaollu@gmail.com",
                "is_verified": false,
                "switch_id": 100266
            }
        },
        {
            "id": 902,
            "amount_kobo": 90000,
            "initiator": "wallet_transfer",
            "fee": "0.0",
            "total_kobo": 90000,
            "transaction_type": "debit",
            "created_at": "2019-05-14T10:19:11.387Z",
            "currency": "NGN",
            "status": "success",
            "transaction": {
                "is_sender": true,
                "sender": {
                    "full_name": "Opemipo Bolaji",
                    "email": "bolajipemipo@gmail.com",
                    "image_selfie_url": "+23408124951038_image_selfie_url_+23408124951038_image_selfie_url_TD3GS8Y7J-UD4B8TB6W-49bd9443e918-512.jpg"
                },
                "recipient": {
                    "full_name": "Olaoluwa Oluro",
                    "email": "ollaollu@gmail.com",
                    "image_selfie_url": "+2348092417972_image_selfie_url_IMG_2026.jpg"
                },
                "full_name": "Olaoluwa Oluro (Transfer Outward)",
                "photo_url": "+2348092417972_image_selfie_url_IMG_2026.jpg"
            },
            "user": {
                "first_name": "Opemipo",
                "last_name": "Bolaji",
                "email": "bolajipemipo@gmail.com",
                "is_verified": false,
                "switch_id": 100123
            }
        }
    ],
    "meta": {
        "total": 619,
        "per_page": 20,
        "page": 1,
        "page_count": 31
    }
}
```

{% endtab %}
{% endtabs %}

## Get Transaction info

<mark style="color:blue;">`GET`</mark> `https://switchapi3.azurewebsites.net/admin/transactions/:transaction_id`

Retrieves transaction info by id

#### Path Parameters

| Name            | Type   | Description               |
| --------------- | ------ | ------------------------- |
| transaction\_id | string | The id of the transaction |

#### Headers

| Name        | Type   | Description                                          |
| ----------- | ------ | ---------------------------------------------------- |
| auth\_token | string | Format for auth\_token is ***Bearer token\_string*** |

{% tabs %}
{% tab title="200 " %}

```
{
    "message": "Transaction retrieved successfully",
    "data": {
        "id": 921,
        "amount_kobo": 5410200,
        "initiator": "wallet_funding",
        "fee": "0.0",
        "total_kobo": 5410200,
        "transaction_type": "credit",
        "created_at": "2019-05-21T17:42:21.250Z",
        "currency": "NGN",
        "status": "pending",
        "transaction": {
            "reference": "630070017607023272200012050",
            "currency": "GBP",
            "payment_processor": "pipit",
            "payment_type": "cash",
            "full_name": "Account funding",
            "photo_url": null
        },
        "user": {
            "first_name": "Demilade",
            "last_name": "Omitiran",
            "email": "omitirand@gmail.com",
            "is_verified": false,
            "switch_id": 100199
        }
    }
}
```

{% endtab %}

{% tab title="404 " %}

```
{
    "message": "transaction with id 92100 does not exist"
}
```

{% endtab %}
{% endtabs %}
