---
title: userTokenVerify
description: >-
  Verifies a user token. See [Verifying
  requests](/docs/api/shop-minis/network-requests#verifying-requests) for more
  details.
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
---

# user​Token​Verify

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

* 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
  ```

```ts
export interface UserTokenVerifyUserError {
  /**
   * Error code associated with the error.
   */
  readonly code:
    | 'TOKEN_INVALID'
    | 'TOKEN_EXPIRED'
    | 'INVALID_MINI'
    | 'USER_NOT_FOUND'

  /**
   * Which input value this error came from.
   */
  readonly field?: (string | null)[]

  /**
   * A description of the error.
   */
  readonly message: string
}
```

Examples

### Examples

* #### Usage

  ##### Default

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

      userErrors {
        code
        field
        message
      }
    }
  }
  ```