A card represents an individual Voice card on a LENS board and is associated with a single list. Cards can include titles, descriptions, due dates, completion data, and archival information. A card is considered archived if it is marked as such individually, or if it lives on a list or tab that is archived. Use this endpoint to retrieve card data across your LENS environment.

Request

GET {LENS_URL}/api/v2/cards

Headers

Include your PAT in the Authorization header of your request.

Header	Description
`token`	Your Personal Access Token

Query Parameters

Parameter	Description	Required
`groupNames`	Comma-separated list of entity `groupNames`.	No
`includeArchived`	Include archived cards in response data.	No
`days`	Filter response data to cards created within the specified number of days prior to the current date. Accepted values range from `1` to `365`, default is `7`.	No

Response

Field	Description	Required
`_id`	The card’s unique ID.	Yes
`boardId`	Associated board `_id` where the card currently lives.	Yes
`createdAt`	Date and time the card was created.	Yes
`completedAt`	Date and time the card was marked as complete.	No
`archived`	Indicates whether the card has been archived, directly or otherwise.	No
`archivedAt`	Date and time the card was archived if archived directly.	No
`title`	The card’s title.	Yes
`description`	The card’s description.	No
`dueDate`	Assigned due date for the card.	No
`listId`	Associated list `_id` where the card currently lives.	Yes
`workflowStateId`	Associated workflow state `_id` for the card.	No

Example Request

GET https://example.safeandreliable.care/api/v2/cards?groupNames=west-er&includeArchived=true

Example Response

{
  "data": [
    {
      "_id": "z9X8yyPJmEjLbCK5k",
      "boardId": "abc5AXYb23tQbEp2J",
      "createdAt": "2026-05-12T15:51:46.543Z",
      "completedAt": null,
      "archived": false,
      "archivedAt": null,
      "title": "Replace IV Pump",
      "description": "Pump in Room 204 requires replacement due to malfunction.",
      "dueDate": "2026-05-25T23:59:59.000Z",
      "listId": "Zb33tMbEp4Jabc1dgI",
      "workflowStateId": null
    },
    {
      "_id": "iNmE12kKNa8iY9KRw",
      "boardId": "abc5AXYb23tQbEp2J",
      "createdAt": "2026-04-28T09:10:45.000Z",
      "completedAt": "2026-04-29T16:30:00.000Z",
      "archived": false,
      "archivedAt": null,
      "title": "Update Staff Training",
      "description": "Annual compliance training materials need to be updated asap.",
      "dueDate": null,
      "listId": "Yb23tQbEp2Jabc5AX",
      "workflowStateId": "601c293d25cad9abc2076123"
    }
  ],
  "metadata": {
    "endpoint": "cards",
    "count": 2,
    "filters": {
      "groupNames": [
        "west-er"
      ],
      "includeArchived": true
    }
  }
}

Looking for more support?

We’re here to help — email us at LENSsupport@safeandreliablecare.com or click the Help button on your LENS board.

Archive or Delete a Card

API Endpoint: Cards