POST /services/webshop/v1/customers/list Auth

List Customers (picker)

Returns project-scoped customers, optionally filtered by a free-text search across email + first/last name. Capped at 50 rows.

Request Body

Field	Type	Required	Description	Example
`search_query`	string\|null max: 191	No		`jane`

Responses

200

422

401

403

429

Customer rows for the picker

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`data`	object[]
`total`	integer

Validation error

Field	Type	Description
`message`	string	Errors overview.
`errors`	object	A detailed description of each field that failed validation.

Unauthenticated — missing or invalid Bearer token

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string

Forbidden — insufficient permissions for this resource

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string

Too Many Requests — rate limit exceeded

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`
`Retry-After`	integer	Seconds until the rate limit resets	`60`

Field	Type	Description
`error`	boolean
`message`	string

Base URL

https://api.wemasy.nl/api

Authentication

Request Sample

cURL

PHP

Python

curl -X POST "https://api.wemasy.nl/api/services/webshop/v1/customers/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "search_query": "jane"
}'

fetch('https://api.wemasy.nl/api/services/webshop/v1/customers/list', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "search_query": "jane"
})})
.then(r => r.json())
.then(data => console.log(data));

$response = Http::withToken('YOUR_API_TOKEN')
    ->accept('application/json')
    ->post('https://api.wemasy.nl/api/services/webshop/v1/customers/list', {
    "search_query": "jane"
});
$data = $response->json();

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
data = {
    "search_query": "jane"
}
r = requests.post("https://api.wemasy.nl/api/services/webshop/v1/customers/list", headers=headers, json=data)
print(r.json())

Response Example

{
    "error": false,
    "data": [
        {
            "id": 7,
            "email": "jane@example.com",
            "firstname": "Jane",
            "lastname": "Smith",
            "label": "Jane Smith (jane@example.com)"
        }
    ],
    "total": 1
}

Try It

Request Body Optional

Export