List card activities

⚠️ BETA endpoint

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

Lists activities for a specific card with optional filtering by id, type, and created_at. Uses cursor-based pagination.

Activity types include:

• vl.card.created
• vl.card.assigned
• vl.card.unassigned
• vl.card.code_generation.succeeded
• vl.card.code_generation.failed

GET /v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/activities

List card activities

cURL

curl --request GET \
  --url https://api.voucherify.io/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/activities \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

200

{
  "data": [
    {
      "id": "<string>",
      "type": "<string>",
      "data": {},
      "created_at": "2023-11-07T05:31:56Z",
      "group_id": "<string>",
      "source": {
        "user": {
          "id": "<string>"
        },
        "api_key": {
          "name": "<string>",
          "app_id": "<string>",
          "client_app_id": "<string>"
        }
      }
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id · string · header · required

X-App-Token · string · header · required

Path Parameters

programId · string · required

Unique program identifier

memberId · string · required

Unique member identifier

cardId · string · required

Unique card identifier

Query Parameters

limit · integer · default: 10

Number of results to return (1-100, default 10)

Required range: 1 <= x <= 100

order · enum<string>

Sort order for results

Available options: created_at, -created_at

cursor · string

Cursor token for pagination

filters[junction] · enum<string>

Available options: AND, OR

filters[id][conditions][$is] · string

filters[id][conditions][$in] · string[]

Maximum array length: 100

filters[type][conditions][$is] · enum<string>

Available options: vl.card.created, vl.card.assigned, vl.card.unassigned, vl.card.code_generation.succeeded, vl.card.code_generation.failed

filters[type][conditions][$in] · string[]

filters[created_at][conditions][$before] · string<date>

filters[created_at][conditions][$after] · string<date>

Response

200

application/json

List of card activities

data · object[]

Show child attributes

cursor · object | null

Cursor for fetching the next page of results.

Show child attributes

object · string

Allowed value: "list"