Search eCards #

Search and page through the eCard designs in your account — handy for building your own gallery, picker, or admin tooling.

Status: Actively evolving (beta). Authenticate with your API key as a Bearer token — Authorization: Bearer YOUR_API_KEY — the same as every other endpoint. For a lighter, widget-scoped listing you can also use GET /pub/ecard-actions/get-ecards. Contact support if you need broader programmatic search access.

Endpoint #

GET https://app.ecardwidget.com/v2/api/ecard/search

Parameters #

Authentication: your API key as a Bearer token (Authorization: Bearer YOUR_API_KEY). Results are scoped to the key's account.

Example #

curl 'https://app.ecardwidget.com/v2/api/ecard/search?page=1&perPage=6&filterByDate=any-time&sortBy=custom-order&widgetID=0' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response #

The standard envelope, with a data array of eCard objects and a meta object (alerts + account limits / pagination):

{
  "success": true,
  "data": [ { "id": 14744, "name": "Happy Birthday", "vanity_id": "e4xgrzltk", "...": "..." } ],
  "meta": { "page": 1, "per_page": 6, "page_count": 3, "total_count": 14 },
  "messages": []
}

Status codes #