---
title: "Get an agent contact card"
method: GET
path: "/contact-cards"
tags: ["Messages"]
---

# Get an agent contact card

`GET /contact-cards`

## Request

- Base URL: `https://osis.co/api/v1/comms`
- URL: `https://osis.co/api/v1/comms/contact-cards`
- Auth: HTTP bearer

Read a hosted agent's saved contact card. Scope: comms_read.

## Query parameters

- `agent_id` string, required

## Response `200`

Saved contact card

- ContactCardResponse
  - `contact_card` ContactCard
    - `agent_id` string
    - `name` string
    - `phone` string
    - `email` string, nullable
    - `note` string, nullable
    - `has_photo` boolean
    - `dedicated` boolean
    - `line_synced` boolean, nullable: true if the line has this card's name, has a photo if the card does, and shares its profile automatically. Only checks that a photo is there, not which photo. false if it didn't update yet. Always null when you read a card.
    - `whatsapp_synced` boolean: Only when the line has WhatsApp: whether the WhatsApp profile took the name and photo.

## Other responses

- `400`: Bad request
- `401`: API key is missing or wrong
- `403`: Your key doesn't have the scope this needs
- `404`: Not found

---

[API](https://skmtc.dev/osis/apis/comms-api.md) · [All operations](https://skmtc.dev/osis/apis/comms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/osis/apis/comms-api/revisions/59a4c0ba8936?raw)