---
title: "Get the attachment status"
method: GET
path: "/api/v2/attach"
tags: ["Card attachment"]
---

# Get the attachment status

`GET /api/v2/attach`

The connected user's latest attachment: `pending` while the user hasn't finished the link, `active` with card details once attached, or `ineligible` with a reason when the card cannot be attached (fall back to wallet funding + `create_card`).

## Query parameters

- `user_id` string, required

## Response `200`

The attachment.

- CardAttachment
  - `object` 'card_attachment', required
  - `id` string, required — The attachment id.
  - `user_id` string, required
  - `status` 'pending' | 'active' | 'ineligible', required — `pending` — the user has not finished the attach link. `active` — attached; `create_card` now mints against this card. `ineligible` — this card cannot be attached; fall back to wallet funding + `create_card`.
  - `attach_url` string — The hosted link the user opens to add their card. Present only on the start response.
  - `expires_at` string, date-time — When the attach link expires (48 hours). Present only on the start response.
  - `card` object — Display details of the attached card. Present when status is `active`.
    - `network` string, nullable
    - `brand` string, nullable
    - `last4` string, nullable
    - `art_url` string, nullable
  - `reason` string — Why the card cannot be attached (e.g. `issuer_excluded`, `commercial_card`). Present when status is `ineligible`.
  - `message` string — Human-readable guidance. Present when status is `ineligible`.

## Other responses

- `400` — `invalid_request` — missing `user_id`.
- `401` — `unauthorized` — the platform access token is missing or expired. Exchange your client credentials for a fresh one.
- `404` — `connection_not_found` — no connection for that user, or `no_attachment` — nothing was ever started.
- `409` — `user_conflict` — the email on file in your organization belongs to a different account. Contact support.

---

[API](https://skmtc.dev/agentcard/apis/agentcard-api.md) · [All operations](https://skmtc.dev/agentcard/apis/agentcard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentcard/agentcard-api/revisions/638d12c8303f/schema)