> ## Documentation Index
> Fetch the complete documentation index at: https://docs.confidolegal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Physical Cards (coming soon)

This page outlines how `Physical Cards` are requested, shipped, and managed through Confido Legal.

## The Physical Card Object

```graphql theme={"system"}
type PhysicalCard {
  id: string
  card: Card
  cardholder: Cardholder
  createdOn: Date
  shipment: Shipment
  status: string
}
```

**Cardholder**

```graphql theme={"system"}
type Cardholder {
  firstName: string
  lastName: string
}
```

**Shipment**

```graphql theme={"system"}
type Shipment {
  address: Address
  method: 'usps' | 'fedex_priority_overnight' | 'fedex_2_day' | 'dhl_worldwide_express'
  status: 'pending' | 'canceled' | 'submitted' | 'acknowledged' | 'rejected' | 'shipped' | 'returned'
  tracking?: TrackingUpdate[]
}
```

## Creating a Physical Card

The `physicalCardCreate` mutation requests a new physical card. Call it with the Firm API token.

```graphql theme={"system"}
mutation PhysicalCardCreate($input: PhysicalCardCreateInput!) {
  physicalCardCreate(input: $input) {
    id
    status
  }
}
```

**Input**

* **`cardId`** — the ID of the card to issue as a physical card
* **`cardholder`** — the cardholder for the physical card

## Update a Physical Card

The `physicalCardUpdate` mutation updates an existing physical card. Call it with the Firm API token.

```graphql theme={"system"}
mutation PhysicalCardUpdate($input: PhysicalCardUpdateInput!) {
  physicalCardUpdate(input: $input) {
    id
    status
  }
}
```

**Input**

* **`id`** — the ID of the physical card to update
* **`status`** — the status of the physical card