---
title: "Retrieve one"
method: GET
path: "/v1/card_issuing_requests/{card_issuing_request_id}"
tags: ["Card issuing request"]
---

# Retrieve one

`GET /v1/card_issuing_requests/{card_issuing_request_id}`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/card_issuing_requests/{card_issuing_request_id}`
- Auth: HTTP bearer

Returns a single card issuing request by id. Visible to the request's owner,
a manager (`card_issuing_requests_manage`), or an admin. Includes the computed
fields `kyc_completed` and `shipping_municipality_name`.

## Path parameters

- `card_issuing_request_id` string, uuid, required

## Parameters

- `#/paths/~1v1~1merchants/get/parameters/0` (unresolved $ref)

## Response `200`

The card issuing request.

- CardIssuingRequest: A single user's request to issue a `VendorCard`. When a user creates a card in the dashboard, a `CardIssuingRequest` is created first; once approved by Cardda staff (or auto-issued) it produces the actual card and `vendor_card_id` is set.
  - `id` string, uuid
  - `name` string, nullable: Display name requested for the card.
  - `user_id` string: Firebase user id of the future cardholder (not a UUID).
  - `company_id` string, uuid
  - `status` 'pending' | 'accepted' | 'declined' | 'printing' | 'printed' | 'sent' | 'delivered': Lifecycle of the request. - `pending` — created, awaiting approval / issuing. - `accepted` — a card was issued and linked (`vendor_card_id` is set). - `declined` — rejected. - `printing` / `printed` — physical card in production. - `sent` — dispatched to the cardholder (admin marks this). - `delivered` — cardholder self-confirmed receipt (see `confirm_delivery`).
  - `budget_cents` integer: Requested spending budget in cents, in `budget_currency`.
  - `budget_currency` string: ISO-4217 code of the requested budget currency.
  - `interval` 'monthly' | 'daily': Budget renewal interval for the resulting card.
  - `physical` boolean: Whether a physical (plastic) card is requested. `false` for virtual-only.
  - `purchase` 'national' | 'international' | 'both', nullable: Allowed purchase geography for the card.
  - `vendor_id` string, nullable: Issuing partner selected at approval time (e.g. `plh`, `pomelo`, `slash`).
  - `vendor_card_id` string, nullable: Id of the issued `VendorCard` once the request is accepted (vendor-prefixed string, not a UUID).
  - `type` string, nullable: STI subclass derived from `vendor_id` (e.g. `Cards::Plh::Request`).
  - `recipient_name` string, nullable: Recipient full name for physical shipments. Required for physical CLP requests.
  - `contact_phone` string, nullable: Contact phone for the physical shipment.
  - `shipping_address` object, nullable: Shipping address for physical CLP requests. `municipality_name` is enriched server-side from `municipality_id`.
    - `street` string
    - `number` string
    - `municipality_id` integer
    - `municipality_name` string
    - `complement` string, nullable
  - `shipping_municipality_name` string, nullable: Resolved municipality name for the shipping address (computed field).
  - `kyc_completed` boolean: Whether the owning company has completed KYC. Computed field. Serialized as the JSON key `kyc_completed` (the `?` Ruby predicate suffix is stripped).
  - `tracking_number` string, nullable: Carrier tracking number (staff-set). Only present for dispatched physical cards.
  - `tracking_url` string, nullable: Carrier tracking URL (staff-set).
  - `estimated_delivery_date` string, date, nullable: Estimated delivery date (staff-set).
  - `shipment_id` string, nullable: Vendor shipment identifier for physical cards.
  - `printing_at` string, date-time, nullable: When the request entered the `printing` milestone.
  - `sent_at` string, date-time, nullable: When the physical card was dispatched.
  - `delivered_at` string, date-time, nullable: When the cardholder confirmed delivery.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `404`: Card issuing request not found (or not visible to the caller).

---

[API](https://skmtc.dev/cardda/apis/cards-api.md) - [All operations](https://skmtc.dev/cardda/apis/cards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/cards-api/revisions/c57a213e5752?raw)