---
title: "Check auth code status"
method: POST
path: "/v1/auth-codes/verify"
tags: ["API Keys"]
---

# Check auth code status

`POST /v1/auth-codes/verify`

Check the status of a temporary authentication code

## Request body

- object
  - `code` string, required
  - `organizationId` string — Organization to attach the device to. Defaults to the caller's JWT org. Lets a multi-org user pair from the org they're viewing.

## Response `200`

Default Response

- object
  - `id` string
  - `code` string
  - `status` 'pending' | 'verified' | 'used' | 'expired'
  - `verified_at` string, nullable
  - `verified_by` string, nullable
  - `used_at` string, nullable
  - `used_by` string, nullable
  - `expires_at` string

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/3b06bcb5f808/schema)