List Cards

Lists cards for the authenticated admin institution, with optional filters and pagination.

Note: Served by Toolzz LXP API (Encore cards). Base URL example: https://lxp.prod.api.toolzz.media.

Request Example

curl --request GET \
  --url 'https://lxp.prod.api.toolzz.media/cards?types_id=1&search=quiz&page=1&quantity_per_page=10&paginate=1&order_field=id&order_direction=DESC' \
  --header 'Authorization: Bearer <token>'

Response Example

{
  "success": true,
  "total": 42,
  "cards": [
    {
      "id": 8708,
      "name": "Sample quiz",
      "ask": "What is 2+2?",
      "type": "quiz",
      "card_types_id": 1,
      "difficulties_id": 1,
      "toolzz_institution_id": 39955387,
      "answers": [
        { "id": 1, "answer": "4", "correct": true },
        { "id": 2, "answer": "3", "correct": false }
      ]
    }
  ]
}

---

Request description

Access Token

Parameter	Type	Description	Required
Authorization	String	Admin JWT (Bearer <token>).	Yes

Query Parameters

Parameter	Type	Description	Required
types_id	number / string	Card type ID(s). Comma-separated allowed (e.g. 1,4).	No
difficulties_id	number	Difficulty ID.	No
search	string	Search text.	No
toolzz_institution_id	number	Must match JWT institution when set.	No
toolzz_school_id	string	School filter.	No
toolzz_groups	string[]	Group filters.	No
toolzz_subgroups	string[]	Subgroup filters.	No
toolzz_specialties	string[]	Specialty filters.	No
paginate	number	1 to enable pagination.	No
page	number	Page number (when paginating).	No
quantity_per_page	number	Page size.	No
order_field	string	Sort field (e.g. id, name).	No
order_direction	string	ASC or DESC (case-sensitive; only ASC sorts ascending, any other value falls back to DESC).	No

---

Error responses

HTTP	Code	When
400	invalid_argument	Invalid types_id or filters
401	unauthenticated	Missing/invalid JWT
403	permission_denied	Not an admin for the institution

---

Security

• Requires admin auth (getAdminActor). Service-account JWT alone is not enough for this endpoint.
• Results scoped to JWT institution.