# Query Member

## 3.4 Query Member

Return the member with the given parameters.

**Request**

| Method | URL                     |
| ------ | ----------------------- |
| GET    | /onboarding/v1/members/ |

**Query Params**

isBuyer (Optional): Filter members by buyer status.

isSubMerchant (Optional): Filter members by sub-merchant status.

memberType (Optional): Filter members by type.

memberExternalId (Optional): Filter members by external ID.

memberIds (Optional): List of member IDs to filter.

name (Optional): Filter members by name.

page (Optional): Page number for pagination.

size (Optional): Number of items per page for pagination.

**Response**

| Status | Response                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | <p>{</p><p>"data": \[</p><p>{</p><p>"id": 1,</p><p>"createdDate": "2022-01-01T12:00:00",</p><p>"updatedDate": "2022-01-02T15:30:00",</p><p>"status": "Active",</p><p>"isBuyer": true,</p><p>"isSubMerchant": false,</p><p>"memberType": "Individual",</p><p>"memberExternalId": "external123",</p><p>"name": "Updated John Doe",</p><p>"address": "456 Updated St, City",</p><p>"email": "<john.doe@example.com>",</p><p>"phoneNumber": "9876543210",</p><p>"identityNumber": "09876543210",</p><p>"contactName": "Updated John",</p><p>"contactSurname": "Updated Doe",</p><p>"legalCompanyTitle": "Doe Enterprises",</p><p>"taxOffice": "City Tax Office",</p><p>"taxNumber": "1234567890",</p><p>"settlementEarningsDestination": "",</p><p>"iban": "TR123456789012345678901234",</p><p>"subMerchantMaximumAllowedNegativeBalance": 200.0</p><p>},</p><p>// ... Additional members</p><p>]</p><p>}</p> |
| 403    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 400    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 500    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

[<br>](https://hilals-organization.gitbook.io/magicpay-documentation/3.-members/3.3-get-member)