---
title: "List cards"
method: GET
path: "/v1/workspaces/{workspace_id}/cards"
tags: ["Cards"]
---

# List cards

`GET /v1/workspaces/{workspace_id}/cards`

## Request

- Base URL: `https://api.blinq.me`
- URL: `https://api.blinq.me/v1/workspaces/{workspace_id}/cards`
- Auth: HTTP bearer

Returns a paginated list of lightweight card summaries from your personal workspace or a business workspace you own or administer. Other workspaces, including business workspaces where you are only a member, return `404`.

Deleted cards, drafts, and card templates are excluded. Each summary includes the public sharing URL for the card.

Cards are sorted by creation time, newest first, with the card ID as a tie-breaker, so pages are deterministic. Cursors are bound to the requesting key owner and workspace.

Requires the `blinq:cards:read` scope.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

One page of card summaries.

- object: One page of card summaries.
  - `cards` object[], required: Card summaries for this page. Empty when the workspace has no visible cards.
    - `id` string, required: The card ID.
    - `workspace_id` string, required: The ID of the workspace containing the card.
    - `url` string, required: The public sharing URL for the card. Anyone with the link can view the card.
    - `card_title` string, nullable, required: The user's title for the card, such as `Work` or `Personal`, or `null` when none is saved. Not the job title.
    - `first_name` string, nullable, required: The first name saved on the card, or `null` when none is saved.
    - `last_name` string, nullable, required: The last name saved on the card, or `null` when none is saved.
    - `job_title` string, nullable, required: The job title saved on the card.
    - `company_name` string, nullable, required: The company name saved on the card.
    - `department` string, nullable, required: The department saved on the card.
    - `qr_code` string, nullable, required: A PNG data URI QR code encoding the card's public sharing URL. Populated by get card; null in lists.
  - `has_more` boolean, required: Whether another page of cards is available.
  - `next_cursor` string, nullable, required: The cursor for the next page. When `has_more` is `true`, pass this value as `cursor`. Otherwise, this value is `null`.
  - `total_count` integer, nullable, required: The total number of visible cards in the workspace. Returned on the first page; `null` on subsequent pages.

## Other responses

- `400`: Bad request - Invalid query parameters or body. See `details` for each failing field
- `401`: Unauthorized - Missing or invalid API key
- `403`: Forbidden - Missing scope, insufficient permission, or the plan does not include this operation
- `404`: Not found - The workspace was not found or access was denied

---

[API](https://skmtc.dev/blinq/apis/blinq-public-api.md) - [All operations](https://skmtc.dev/blinq/apis/blinq-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blinq/apis/blinq-public-api/revisions/2dedf4b14340?raw)