---
title: userTokenVerify
description: Verifies a user token.
api_name: shop-minis
source_url:
  html: >-
    https://shopify.dev/docs/api/shop-minis/minis-admin-api/mutations/usertokenverify
  md: >-
    https://shopify.dev/docs/api/shop-minis/minis-admin-api/mutations/usertokenverify.md
---

# userTokenVerify

Verifies a user token. See [Verifying requests](https://shopify.dev/docs/api/shop-minis/network-requests#verifying-requests) for more details.

#### Input

Input arguments for the mutation.

* **token**

  **string**

  **required**

  The temporary user token to verify.

#### Return type

This mutation returns a `UserTokenVerifyPayload` object with the following fields:

* **userErrors**

  **UserTokenVerifyUserError\[]**

  **required**

  List of errors that occured while executing the mutation.

* **publicId**

  **string | null**

  The public ID of the user.

* **tokenExpiresAt**

  **ISO8601DateTime | null**

  The expiration date of the token.

* **userState**

  **'VERIFIED' | 'GUEST' | null**

  The state of the user.

* **userIdentifier**

  **string | null**

  **deprecated**

  A permanent identifier for the user.

  **Deprecated:**

  Use publicId instead.

### ISO8601DateTime

```ts
string
```

### UserTokenVerifyUserError

A user or client error that could occur during the execution of the \`userTokenVerify\` mutation.

* code

  Error code associated with the error.

  ```ts
  | 'TOKEN_INVALID'
      | 'TOKEN_EXPIRED'
      | 'INVALID_MINI'
      | 'USER_NOT_FOUND'
  ```

* field

  Which input value this error came from.

  ```ts
  string[]
  ```

* message

  A description of the error.

  ```ts
  string
  ```

Examples

### Examples

* ####

  ##### graphql

  ```graphql
  mutation VerifyUserToken($token: String!) {
    userTokenVerify(token: $token) {
      tokenExpiresAt
      publicId

      userErrors {
        code
        field
        message
      }
    }
  }
  ```

***