---
title: "Get current list of contact ids for given user id"
method: GET
path: "/contacts-for-user/{user_guid}"
tags: ["User"]
---

# Get current list of contact ids for given user id

`GET /contacts-for-user/{user_guid}`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/contacts-for-user/{user_guid}`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

## Path parameters

- `user_guid` string, required

## Response `200`

- Contact[]
  - `user_guid` string, required
  - `image_url` string, nullable, required
  - `first_name` string, required
  - `last_name` string, required
  - `languages` string[], required
  - `voice_gender` 'F' | 'M', required
  - `created_by` string, nullable, required
  - `created_at` string, date-time, required
  - `last_updated_at` string, date-time, nullable, required
  - `workspace_guids` string[], required
  - `workspace_roles` WorkspaceRole[], required
    - `workspace_id` string, required
    - `role` 'admin' | 'owner' | 'creator' | 'member' | 'guest', required
    - `joined_at` string, date-time, nullable
    - `sort_order` number, nullable
  - `is_allowed_to_receive_notification` boolean, required
  - `user_type` 'user' | 'bot' | 'agent', required
  - `is_agent` boolean, required
  - `owner_id` string, nullable, required

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)