---
title: "Endpoint to verify if list of (users, emails, phones) have access to a specific resource"
method: POST
path: "/users/verify-access"
tags: ["User"]
---

# Endpoint to verify if list of (users, emails, phones) have access to a specific resource

`POST /users/verify-access`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/users/verify-access`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

## Request body

- WhoHasAccessPayload
  - `resource_type` 'workspace' | 'channel' | 'message' | 'sharelink', required
  - `resource_id` string, required: The resource id to verify who has access to it (workspace_id, channel_id, message_id, etc)
  - `user_ids` string[]: List of user_ids to verify if they have access to the resource
  - `emails` string[]: List of emails to verify if they have access to the resource
  - `phones` string[]: List of phones to verify if they have access to the resource

## Response `200`

- WhoHasAccessResponse
  - `resource_type` 'workspace' | 'channel' | 'message' | 'sharelink', required
  - `resource_id` string, required: The resource id to verify who has access to it (workspace_id, channel_id, message_id, etc)
  - `has_access` WithOrNoAccess, required
    - `user_ids` string[], required: List of informed user_ids
    - `emails` object[], required: Map of email to user_id
    - `phones` object[], required: Map of phones to user_id
  - `no_access` WithOrNoAccess, required
    - `user_ids` string[], required: List of informed user_ids
    - `emails` object[], required: Map of email to user_id
    - `phones` object[], required: Map of phones to user_id

## Other responses

- `403`

---

[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)