---
title: "Get a card"
method: GET
path: "/api/board/{boardId}/{cardId}"
tags: ["Cards"]
---

# Get a card

`GET /api/board/{boardId}/{cardId}`

## Request

- Base URL: `https://core-api.getaptly.com`
- URL: `https://core-api.getaptly.com/api/board/{boardId}/{cardId}`
- Auth: one of:
  - API key in header `x-token`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/getaptly/apis/aptly-api/docs/api/board/:boardId/:cardId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single card by its ID.

## Path parameters

- `boardId` string, required
- `cardId` string, required

## Response `200`

Card data.

- object
  - `data` Card
    - `cardId` string: Unique ID of the card.
    - `boardUuid` string: UUID of the board this card belongs to.
    - `archived` boolean
    - `assignee` string: Full name of the assigned user.
    - `lastActivity` object, nullable: Most recent conversation activity on the card (email, SMS or call), or null if the card has none.
      - `content` string, nullable: Body/text preview of the most recent message.
      - `type` string, nullable: Activity type, e.g. `email`, `sms`, `voice`.
      - `direction` 'in' | 'out', nullable: Direction of the message — `in` (inbound) or `out` (outbound).
      - `publishedAt` string, date-time, nullable
      - `conversationUrl` string, nullable: Deep link to the conversation thread in Aptly. Null when the activity is not attached to a thread.

## Other responses

- `401`: Invalid or missing API key.
- `403`: API access is disabled for this board.
- `404`: Card not found.

---

[API](https://skmtc.dev/getaptly/apis/aptly-api.md) - [All operations](https://skmtc.dev/getaptly/apis/aptly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaptly/apis/aptly-api/revisions/75c367e0b8e5?raw)