# Connected Account Transactions

### Getting one connected account transactions 

## Getting a transaction for one connected account

<mark style="color:blue;">`GET`</mark> `https://api2.ourpass.co/v1/business/subaccounts/478?getWallet=true`

#### Path Parameters

| Name                                           | Type   | Description                                                  |
| ---------------------------------------------- | ------ | ------------------------------------------------------------ |
| subAccountId<mark style="color:red;">\*</mark> | String | This is the unique ID of the connected account to be gotten. |

#### Query Parameters

| Name  | Type   | Description                                                 |
| ----- | ------ | ----------------------------------------------------------- |
| page  | String | The is the number of pages you want to be able to see       |
| limit | String | This is the number of transactions you want to see per page |

#### Headers

| Name                                     | Type   | Description                                                   |
| ---------------------------------------- | ------ | ------------------------------------------------------------- |
| apiKey<mark style="color:red;">\*</mark> | String | Pass your api key in the request header to authorise the call |

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

```javascript
{
    "message": "Transactions retrieved successfully",
    "data": {
        "balance": 418043023,
        "currency": "NGN",
        "inflowAmount": 233200,
        "transactions": [
            {
                "id": 8849,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "0ca2e643-cbc3-44b2-8359-ab0c6a2eb390",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 07:13:31 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989847,
                "balanceAfter": 31989847,
                "subAccountId": 375
            },
            {
                "id": 8846,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "a9606956-2f59-4984-a803-8fa535dff2a0",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 07:01:40 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989847,
                "balanceAfter": 31989847,
                "subAccountId": 375
            },
            {
                "id": 8834,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "46ca86a5-50ab-43dd-b5d7-b1ff125e3846",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 06:27:06 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989757,
                "balanceAfter": 31989757,
                "subAccountId": 375
            },
            {
                "id": 8831,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "0e744646-d104-4a4b-981b-a4de639aef68",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 06:26:40 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989757,
                "balanceAfter": 31989757,
                "subAccountId": 375
            },
            {
                "id": 8816,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "125795a7-b5bf-47ad-bc31-b874aebfb151",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 13:33:42 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8813,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "20fd31ba-33bb-4eda-981c-87adbb7552e9",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 13:33:06 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8810,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "a42793c5-d35c-40c6-a117-00a240076eb2",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 13:32:48 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8807,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "b3cfc41b-108b-43f2-9abe-a12d2fa26df2",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 13:31:34 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8803,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "a34cd8fe-3eed-49e9-bd12-8a07415901cc",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 11:34:15 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8801,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "5e8fd729-6e23-4fd8-891e-fbff1db3387d",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 11:30:34 GMT+0000 (Coordinated Universal Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            }
        ],
        "totalCount": 11,
        "connectedFees": 0
    }
}
```

{% endtab %}
{% endtabs %}

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

```
curl --location --request GET 'https://user-api2-staging.ourpass.co/v1/api/subaccounts/375/transactions?page=1&limit=10' \
--header 'apiKey: {{apiKey}}' \
--data-raw ''
```

{% endtab %}

{% tab title="Node.js" %}

```
var axios = require('axios');
var data = '';

var config = {
  method: 'get',
  url: 'https://user-api2-staging.ourpass.co/v1/api/subaccounts/375/transactions?page=1&limit=10',
  headers: { 
    'apiKey': '{{apiKey}}'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

```

{% endtab %}

{% tab title="PHP" %}

```
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://user-api2-staging.ourpass.co/v1/api/subaccounts/375/transactions?page=1&limit=10');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'apiKey' => '{{apiKey}}'
));
$request->setBody('');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
```

{% endtab %}

{% tab title="Ruby" %}

```
require "uri"
require "net/http"

url = URI("https://user-api2-staging.ourpass.co/v1/api/subaccounts/375/transactions?page=1&limit=10")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["apiKey"] = "{{apiKey}}"

response = https.request(request)
puts response.read_body

```

{% endtab %}

{% tab title="Python" %}

```
import requests

url = "https://user-api2-staging.ourpass.co/v1/api/subaccounts/375/transactions?page=1&limit=10"

payload = ""
headers = {
  'apiKey': '{{apiKey}}'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}
{% endtabs %}

### Getting all connected account transactions

## Getting all transaction for connected accounts

<mark style="color:blue;">`GET`</mark> `https://api2.ourpass.co/v1/business/subaccounts/transactions`

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

```javascript
{
    "message": "Transactions retrieved successfully",
    "data": {
        "balance": 34849423,
        "currency": "NGN",
        "inflowAmount": 1433200,
        "transactions": [
            {
                "id": 9033,
                "amount": 400000,
                "purpose": "product_sale",
                "reference": "4eec490c-d634-450f-848d-d0f834ade5c5",
                "description": "love1-Sex-Toy-2-for-Deji and  x 4",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://paylidate.com\",\"credited_into\":\"ledger\"}",
                "createdAt": "Mon Apr 11 2022 16:33:06 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 34864223,
                "balanceAfter": 34864223,
                "subAccountId": 1297
            },
            {
                "id": 9029,
                "amount": 400000,
                "purpose": "product_sale",
                "reference": "a430f658-f30a-4c09-b0cb-2bb2d1c7db4f",
                "description": "love1-Sex-Toy-2-for-Deji and  x 4",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://paylidate.com\",\"credited_into\":\"ledger\"}",
                "createdAt": "Mon Apr 11 2022 16:32:48 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 34869823,
                "balanceAfter": 34869823,
                "subAccountId": 1297
            },
            {
                "id": 8967,
                "amount": 400000,
                "purpose": "product_sale",
                "reference": "ca215746-9349-4a76-81d9-997a4608253a",
                "description": "love1-Sex-Toy-2-for-Deji and  x 4",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://paylidate.com\",\"credited_into\":\"ledger\"}",
                "createdAt": "Wed Apr 06 2022 11:22:18 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 32472223,
                "balanceAfter": 32472223,
                "subAccountId": 1289
            },
            {
                "id": 8849,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "0ca2e643-cbc3-44b2-8359-ab0c6a2eb390",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 08:13:31 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989847,
                "balanceAfter": 31989847,
                "subAccountId": 375
            },
            {
                "id": 8846,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "a9606956-2f59-4984-a803-8fa535dff2a0",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 08:01:40 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989847,
                "balanceAfter": 31989847,
                "subAccountId": 375
            },
            {
                "id": 8834,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "46ca86a5-50ab-43dd-b5d7-b1ff125e3846",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 07:27:06 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989757,
                "balanceAfter": 31989757,
                "subAccountId": 375
            },
            {
                "id": 8831,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "0e744646-d104-4a4b-981b-a4de639aef68",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Fri Mar 25 2022 07:26:40 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31989757,
                "balanceAfter": 31989757,
                "subAccountId": 375
            },
            {
                "id": 8816,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "125795a7-b5bf-47ad-bc31-b874aebfb151",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 14:33:42 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8813,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "20fd31ba-33bb-4eda-981c-87adbb7552e9",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 14:33:06 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8810,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "a42793c5-d35c-40c6-a117-00a240076eb2",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 14:32:48 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8807,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "b3cfc41b-108b-43f2-9abe-a12d2fa26df2",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 14:31:34 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8803,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "a34cd8fe-3eed-49e9-bd12-8a07415901cc",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 12:34:15 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8801,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "5e8fd729-6e23-4fd8-891e-fbff1db3387d",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 12:30:34 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            },
            {
                "id": 8798,
                "amount": 21200,
                "purpose": "product_sale",
                "reference": "6ff5a332-cc50-4890-8888-9a3711587db7",
                "description": "Hello and  x 1",
                "metadata": "{\"payment_method\":\"wallet\",\"source\":\"https://kissanime.com.ru\",\"credited_into\":\"ledger\"}",
                "createdAt": "Thu Mar 24 2022 12:19:12 GMT+0100 (West Africa Standard Time)",
                "type": "credit",
                "walletId": 212,
                "balanceBefore": 31810257,
                "balanceAfter": 31810257,
                "subAccountId": 375
            }
        ],
        "totalCount": 14,
        "connectedFees": 0
    }
}
```

{% endtab %}
{% endtabs %}

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

```
curl --location --request GET 'https://api2.ourpass.co/v1/business/subaccounts/transactions' \
--header 'apiKey: pass_sec_live_46PhAGxwjVslPCKSpelAMxTupNmcBJem' \
--data-raw ''
```

{% endtab %}

{% tab title="Node.js" %}

```
var axios = require('axios');
var data = '';

var config = {
  method: 'get',
  url: 'https://api2.ourpass.co/v1/business/subaccounts/transactions',
  headers: { 
    'apiKey': 'pass_sec_live_46PhAGxwjVslPCKSpelAMxTupNmcBJem'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

```

{% endtab %}

{% tab title="PHP" %}

```
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api2.ourpass.co/v1/business/subaccounts/transactions');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'apiKey' => 'pass_sec_live_46PhAGxwjVslPCKSpelAMxTupNmcBJem'
));
$request->setBody('');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
```

{% endtab %}

{% tab title="Ruby" %}

```
require "uri"
require "net/http"

url = URI("https://api2.ourpass.co/v1/business/subaccounts/transactions")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["apiKey"] = "pass_sec_live_46PhAGxwjVslPCKSpelAMxTupNmcBJem"

response = https.request(request)
puts response.read_body

```

{% endtab %}

{% tab title="Python" %}

```
import requests

url = "https://api2.ourpass.co/v1/business/subaccounts/transactions"

payload = ""
headers = {
  'apiKey': 'pass_sec_live_46PhAGxwjVslPCKSpelAMxTupNmcBJem'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ourpass.co/connect/connected-account-transactions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.