## Get contact cards

`contact_card.retrieve(ContactCardRetrieveParams**kwargs)  -> ContactCardRetrieveResponse`

**get** `/v3/contact_card`

Returns the contact card for a specific phone number, or all contact cards for the
authenticated partner if no `phone_number` is provided.

### Parameters

- `phone_number: Optional[str]`

  E.164 phone number to filter by. If omitted, all my cards for the partner are returned.

### Returns

- `class ContactCardRetrieveResponse: …`

  - `contact_cards: List[ContactCard]`

    - `first_name: str`

    - `is_active: bool`

    - `phone_number: str`

    - `image_url: Optional[str]`

    - `last_name: Optional[str]`

### Example

```python
import os
from linq import LinqAPIV3

client = LinqAPIV3(
    api_key=os.environ.get("LINQ_API_V3_API_KEY"),  # This is the default and can be omitted
)
contact_card = client.contact_card.retrieve()
print(contact_card.contact_cards)
```

#### Response

```json
{
  "contact_cards": [
    {
      "phone_number": "+15551234567",
      "first_name": "John",
      "last_name": "Doe",
      "image_url": "https://cdn.linqapp.com/contact-card/example.jpg",
      "is_active": true
    }
  ]
}
```