---
description: Get all assigned dynamic FSDH 360 accounts by BVN
---

# Dynamic accounts by BVN

## Get all assigned dynamic FSDH 360 accounts by BVN

<mark style="color:blue;">`GET`</mark> `https://api-fsdh360-test.fsdhgroup.com/api/v1/virtualaccounts/dynamic/assigned/bvn`

To retrieve dynamic account details by BVN the below query parameters should be provided.

Attention should be given to parameters marked <mark style="color:red;">\*</mark>`required`.

#### Query Parameters

| Name                                  | Type   | Description                     |
| ------------------------------------- | ------ | ------------------------------- |
| BVN<mark style="color:red;">\*</mark> | String | Clients BVN                     |
| Skip                                  | String | The number of records to skip   |
| Take                                  | String | The number of records to return |
| API-version                           | String | Version of API                  |

{% tabs %}
{% tab title="200: OK Success" %}
```javascript
[
  {
    "accountNumber": "string",
    "accountName": "string",
    "collectionAccountNumber": "string",
    "bvn": "string",
    "accountType": 1,
    "accountCurrency": "string",
    "hasExpired": true,
    "expires": "2022-12-07T10:12:48.440Z",
    "uniqueReference": "string",
    "isOneTimePaymentAccount": true,
    "expectedAmount": "string"
  }
]
```
{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}
```javascript
```
{% endtab %}

{% tab title="403: Forbidden Forbidden" %}
```javascript
```
{% endtab %}

{% tab title="500: Internal Server Error Internal Server Error" %}
<pre class="language-javascript"><code class="lang-javascript"><strong>
</strong></code></pre>
{% endtab %}

{% tab title="400: Bad Request Bad Request" %}
```javascript
```
{% endtab %}
{% endtabs %}

<figure><img src="https://1085485156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCvMerIdO3ETvUtkUdDyc%2Fuploads%2F7B0RuF4bD76mjs2lAeyZ%2FdynamicAcctsByBVN.png?alt=media&#x26;token=65d05550-380b-472c-8afa-f66eaa6b00c0" alt=""><figcaption><p>Curl and Request URL</p></figcaption></figure>

<figure><img src="https://1085485156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCvMerIdO3ETvUtkUdDyc%2Fuploads%2F0BU9YkXLDzTSBSCQh0L9%2FdynamicAcctsByBVN2.png?alt=media&#x26;token=1967dcc8-83e0-45bb-b71a-017c75d4c86e" alt=""><figcaption><p>Server response</p></figcaption></figure>

{% code title="Request Body " %}
```json
{
  "BVN": "string"
}
```
{% endcode %}

#### Response body

Inputting the correct parameters should give you a <mark style="color:green;">`200`</mark>`: Success` response which will populate the below Success details. Also specified are possible responses from the request.

{% tabs %}
{% tab title="200: Success" %}
```json
[
  {
    "accountNumber": "string",
    "accountName": "string",
    "collectionAccountNumber": "string",
    "bvn": "string",
    "accountType": 1,
    "accountCurrency": "string",
    "hasExpired": true,
    "expires": "2022-06-07T11:17:57.983Z",
    "uniqueReference": "string",
    "isOneTimePaymentAccount": true
  }
]
```
{% endtab %}

{% tab title="400: Bad Request" %}
```json
{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-5882c7f4999c0146881de12d515bf169-8cfd66e28b1f9940-00",
  "errors": {
    "BVN": [
      "BVN should be 11 digits long"
    ]
  }
}
```
{% endtab %}
{% endtabs %}

