# List Account

Use this endpoint to retrieve information about your sub accounts. You can filter by email, creation date, type, name, or status. The results are paginated and ordered by creation date<br>

| Environment | Method | URL                                                  |
| ----------- | ------ | ---------------------------------------------------- |
| Development | GET    | <https://devo.finnet.co.id/was-adapter/account/list> |
| Production  | GET    | <https://live.finnet.co.id/was-adapter/account/list> |

### Header Request <a href="#body-request" id="body-request"></a>

| Name          | Type   | Mandatory | Description                                                                                                                           |
| ------------- | ------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization | String | M         | <p>Represents Basic Authentication.</p><p>e.g. Basic dW5kZWZpbmVkOnBhc3N3b3Jk</p>                                                     |
| accept        | String | M         | Mandatory header to specify the response format. Must be set to `application/json` so the server returns the response in JSON format. |

### Body Request <a href="#body-request" id="body-request"></a>

<table><thead><tr><th width="75">No</th><th>Name</th><th width="105">Type</th><th width="121">Mandatory</th><th width="125">Min Length</th><th width="125">Max Length</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>email</td><td>array of string</td><td>O</td><td>5</td><td>255 (each item)</td><td><strong>Filter by account email list.</strong> If not provided, all emails will be returned.</td></tr><tr><td>2</td><td>status</td><td>array of string</td><td>O</td><td>1</td><td>25 (each item)</td><td><strong>Filter by account status.</strong><br>Valid values: <code>INVITED</code>, <code>REGISTERED</code>, <code>AWAITING_DOCS</code>, <code>LIVE</code>, <code>SUSPENDED</code></td></tr><tr><td>3</td><td>public_profile.business_name</td><td>String</td><td>O</td><td>1</td><td>512</td><td><strong>Filter by business name (public profile)</strong> used during account creation.</td></tr><tr><td>4</td><td>type</td><td>String</td><td>O</td><td>5</td><td>15</td><td><strong>Filter by account type.</strong><br>Valid values: <code>MANAGED</code>, <code>OWNED</code></td></tr><tr><td>5</td><td>created[gte]</td><td>string (date-time)</td><td>O</td><td>24</td><td>24</td><td>Start time filter based on the account creation date.</td></tr><tr><td>6</td><td>created[lte]</td><td>string (date-time)</td><td>O</td><td>24</td><td>24</td><td>End time filter based on the account creation date.</td></tr><tr><td>7</td><td>updated[gte]</td><td>string (date-time)</td><td>O</td><td>24</td><td>24</td><td>Start time filter based on the account last updated date.</td></tr><tr><td>8</td><td>updated[lte]</td><td>string (date-time)</td><td>O</td><td>24</td><td>24</td><td>End time filter based on the account last updated date.</td></tr><tr><td>9</td><td>limit</td><td>number</td><td>O</td><td>1</td><td>50</td><td><strong>Maximum number of records per request.</strong><br>Min: 1 • Max: 50 • Default: 10</td></tr><tr><td>10</td><td>before_id</td><td>String</td><td>O</td><td>1</td><td>36</td><td>Next item ID for pagination.</td></tr><tr><td>11</td><td>after_id</td><td>String</td><td>O</td><td>1</td><td>36</td><td>Previous item ID for pagination.</td></tr></tbody></table>

#### Sample Request <a href="#sample-request" id="sample-request"></a>

```
curl --request GET \
  --url ' https://devo.finnet.co.id/was-adapter/list/account?email=kirana%finnet.com&public_profile.business_name=PT%20Satu%20Dua%20Tiga&type=OWNED&limit=10' \
  --header 'accept: application/json' \
  --header 'authorization: Basic YXNkYXNkOnBhc3N3b3Jk'
```

### Body Response <a href="#body-response" id="body-response"></a>

<table><thead><tr><th width="74">No</th><th width="128">Name</th><th width="115">Type</th><th width="119">Mandatory</th><th width="123">Min Length</th><th>Max Length</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>data</td><td>array of object</td><td>M</td><td></td><td></td><td>List of returned accounts</td></tr><tr><td>2</td><td>data[].id</td><td>String</td><td>M</td><td></td><td>36</td><td>Unique account identifier</td></tr><tr><td>3</td><td>data[].created</td><td>String (date-time)</td><td>M</td><td></td><td>24</td><td><strong>Account creation date and time</strong> (ISO 8601)</td></tr><tr><td>4</td><td>data[].updated</td><td>String (date-time)</td><td>M</td><td></td><td>240</td><td><strong>Account last updated date and time</strong></td></tr><tr><td>5</td><td>data[].type</td><td>String</td><td>M</td><td></td><td>15</td><td><strong>Account type</strong><br>Valid values: <code>MANAGED</code>, <code>OWNED</code></td></tr><tr><td>6</td><td>data[].email</td><td>String</td><td>M</td><td></td><td>255</td><td>Account email address</td></tr><tr><td>7</td><td>data[].public_profile</td><td>Object</td><td>M</td><td></td><td>512</td><td><strong>Public profile information of the account</strong></td></tr><tr><td>8</td><td>data[].public_profile.business_name</td><td>String</td><td>M</td><td>1</td><td>255</td><td><strong>Business name / public profile name</strong></td></tr><tr><td>9</td><td>data[].public_profile.description</td><td>String</td><td>O</td><td>1</td><td>500</td><td><strong>Short business description</strong></td></tr><tr><td>10</td><td>data[].country</td><td>String</td><td>M</td><td>2</td><td>2</td><td><strong>Country code</strong> (ISO 3166-1 alpha-2)</td></tr><tr><td>11</td><td>data[].status</td><td>String</td><td>M</td><td></td><td></td><td><strong>Account status</strong><br>Valid values: <code>INVITED</code>, <code>REGISTERED</code>, <code>AWAITING_DOCS</code>, <code>LIVE</code>, <code>SUSPENDED</code></td></tr><tr><td>12</td><td>has_more</td><td>boolean</td><td>M</td><td></td><td></td><td><strong>Indicates whether more data is available</strong> (pagination)</td></tr><tr><td>13</td><td>links</td><td>array of object</td><td>M</td><td></td><td></td><td>Pagination link information</td></tr><tr><td>14</td><td>links[].href</td><td>String</td><td>M</td><td></td><td></td><td>Pagination URL</td></tr><tr><td>15</td><td>links[].rel</td><td>String</td><td>M</td><td></td><td>20</td><td><strong>Pagination link relation</strong> (example: <code>next</code>, <code>prev</code>)</td></tr><tr><td>16</td><td>links[].method</td><td>String</td><td>M</td><td></td><td>10</td><td>HTTP method for pagination</td></tr></tbody></table>

#### Sample Response <a href="#sample-response" id="sample-response"></a>

```
{
  "data": [
    {
      "id": "123asdasdnj1231wesa",
      "created": "2025-02-01T10:00:00Z",
      "updated": "2025-02-01T10:00:00Z",
      "type": "OWNED",
      "email": "kirana@finnet.com",
      "public_profile": {
        "business_name": "PT Satu dua"
      },
      "status": "LIVE"
    },
    {
      "id": "123asdasdnj1231wes2",
      "created": "2025-03-22T09:15:00Z",
      "updated": "2025-03-22T09:30:00Z",
      "type": "MANAGED",
      "email": "kirana@finpay.com",
      "public_profile": {
        "business_name": "PT 3 4 5"
      },
      "status": "LIVE"
    }
  ],
  "has_more": true,
  "links": [
    {
      "href": "/v2/accounts?after_id=623ace8270bbddf93816b3g1",
      "rel": "next",
      "method": "GET"
    }
  ]
} 
```

#### Sample Response (Negative) <a href="#sample-response" id="sample-response"></a>

```
{
    "error_code": "API_VALIDATION_ERROR",
    "message": "There was an error with the format submitted to the server.",
    "errors": [
        {
            "field": [
                "limit"
            ],
            "location": "query",
            "messages": [
                "\"limit\" must be larger than or equal to 1"
            ],
            "types": [
                "number.min"
            ]
        }
    ]
}
```

### List Account HTTP Status Code <a href="#sample-response" id="sample-response"></a>

<table><thead><tr><th width="71">No</th><th width="172">HTTP Status Code</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>200</td><td>Success with Response Body Message</td></tr><tr><td>2</td><td>400</td><td>[ <code>API_VALIDATION_ERROR</code>, <code>INVALID_CONFIGURATION</code>, <code>INVALID_JSON_FORMAT</code>, <code>TYPE_AND_CONFIGURATION_CONFLICT</code>, <code>INVALID_SOURCE_OR_DESTINATION_ERROR</code>, <code>INSUFFICIENT_BALANCE</code>, <code>INVALID_FEE_AMOUNT</code>, <code>DUPLICATE_ERROR</code>, <code>INVALID_AMOUNT</code>, <code>INSUFFICIENT_ACCOUNT_HOLDER_DATA</code>, <code>MISMATCH_PAYLOAD_FOR_REFERENCE</code>, <code>INVALID_URL_FORMAT</code> ]</td></tr><tr><td>3</td><td>404</td><td>[ <code>DESTINATION_ACCOUNT_NOT_FOUND</code>, <code>DATA_NOT_FOUND</code>, <code>CALLBACK_AUTHENTICATION_TOKEN_NOT_FOUND_ERROR</code> ]</td></tr></tbody></table>


---

# 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.finpay.id/api-reference/finpay-wallet-as-a-service/core-api/list-account.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.