List cards for a specific employee

Request

🔒 Private label — contact sales. Requires a private-label entitlement on your API client.

Returns paginated cards for the given employee. Accessible by CARD_USER and admin roles.

Security

oauth2ClientCredentials(Required scopes: cards:read)

Path

employeeIdstringrequired

Query

pagenumber

Page number (minimum: 1)

Example:page=1

limitnumber

Number of items per page

Example:limit=20

org_wallet_refstring

Organization wallet reference, defaults to "1" if not provided

business_idstringrequired

Business identifier for the request

curl -i -X GET \
  'https://developer.boyahq.com/_mock/v2/openapi/cards/employee/{employeeId}?page=1&limit=20' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'business_id: string' \
  -H 'org_wallet_ref: string'

Responses

Paginated list of employee cards

Bodyapplication/json

docsArray of objects(CardV1Dto)

Card documents

totalnumber

Total count

limitobject

Limit per page

pageobject

Current page

pagesnumber

Total pages

Response

{
  "docs": [
    { … }
  ],
  "total": 0,
  "limit": {},
  "page": {},
  "pages": 0
}