---
title: "Changes to Verify an authentication credential"
method: POST
path: "/auth/credentials/{id}/verify"
---

# Changes to Verify an authentication credential

`POST /auth/credentials/{id}/verify`

> Every recorded change to this operation, newest first.
> 115 revisions in range; 2 not diffed.

## Timeline

Changed in 11 of 115 revisions.

- **2026-10-28** `d996ddfb9d2b`: 2 info
- **2026-10-24** `715332dcb111`: 1 warning
- **2026-10-20** `761d1d030cb5`: 1 warning
- **2026-10-16** `2b37da73f455`: 1 warning
- **2026-10-16** `9381e13d6f74`: 2 breaking, 1 warning
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
- **2026-10-05** `6d67fe99049c`: 3 info
- **2026-10-05** `32bcbd4023e4`: 2 warning, 1 info
- **2026-10-02** `dfe5a02f2fee`: 14 breaking, 47 warning, 13 info
- **2026-05-28** `d0bce562bffd`: 3 breaking, 10 warning, 2 info
- **2026-04-27** `5b8a8161eeb3`: 1 info

## Changes

- **2026-10-28** `d996ddfb9d2b`: 2 info
  - added the optional property `details/missingFields` to the response with the `400` status
  - added the optional property `details/refusalReason` to the response with the `400` status
- **2026-10-24** `715332dcb111`: 1 warning
  - added the new `EXACT_AMOUNT_UNAVAILABLE` enum value to the `code` response property for the response status `400`
- **2026-10-20** `761d1d030cb5`: 1 warning
  - added the new `CARDHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-16** `2b37da73f455`: 1 warning
  - changed the pattern of the request property `oneOf[subschema #3: OAuth Credential Verify Request]/allOf[#/components/schemas/OauthCredentialVerifyRequestFields]/clientPublicKey` from `^0[23][0-9a-fA-F]{64}$` to `^0[23][0-9a-f]{64}$`
- **2026-10-16** `9381e13d6f74`: 2 breaking, 1 warning
  - the `oneOf[subschema #3: OAuth Credential Verify Request]/allOf[#/components/schemas/OauthCredentialVerifyRequestFields]/clientPublicKey` request property's minLength was increased from `0` to `66`
  - added the pattern `^0[23][0-9a-fA-F]{64}$` to the request property `oneOf[subschema #3: OAuth Credential Verify Request]/allOf[#/components/schemas/OauthCredentialVerifyRequestFields]/clientPublicKey`
  - the `oneOf[subschema #3: OAuth Credential Verify Request]/allOf[#/components/schemas/OauthCredentialVerifyRequestFields]/clientPublicKey` request property's maxLength was set to `66`
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
  - added the new `ACCOUNTHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-05** `6d67fe99049c`: 3 info
  - removed the `INVALID_PAYREQ_RESPONSE` enum value from the `code` response property for the response status `400`
  - removed the `LOOKUP_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
  - removed the `QUOTE_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
- **2026-10-05** `32bcbd4023e4`: 2 warning, 1 info
  - added the new `AUTH_CREDENTIAL_VERIFICATION_EXPIRED` enum value to the `code` response property for the response status `400`
  - added the new `AUTH_CREDENTIAL_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the success response with the status `204`
- **2026-10-02** `dfe5a02f2fee`: 14 breaking, 47 warning, 13 info
  - added the new required request property `oneOf[subschema #1: Email OTP Credential Verify Request]/allOf[#/components/schemas/EmailOtpCredentialVerifyRequestFields]/encryptedOtpBundle`
  - added `#/components/schemas/AuthCredentialVerifyRequest` to the `oneOf[subschema #1: Email OTP Credential Verify Request]/` request property `allOf` list
  - added `#/components/schemas/AuthCredentialVerifyRequest` to the `oneOf[subschema #2: OAuth Credential Verify Request -> subschema #3: OAuth Credential Verify Request]/` request property `allOf` list
  - added `#/components/schemas/AuthCredentialVerifyRequest` to the `oneOf[subschema #3: Passkey Credential Verify Request -> subschema #4: Passkey Credential Verify Request]/` request property `allOf` list
  - removed the required property `message` from the response with the `400` status
  - removed the required property `message` from the response with the `401` status
  - removed the required property `message` from the response with the `404` status
  - removed the required property `message` from the response with the `429` status
  - removed the required property `message` from the response with the `500` status
  - removed the required property `status` from the response with the `400` status
  - removed the required property `status` from the response with the `401` status
  - removed the required property `status` from the response with the `404` status
  - removed the required property `status` from the response with the `429` status
  - removed the required property `status` from the response with the `500` status
  - removed `subschema #1` from the `oneOf[subschema #1: Email OTP Credential Verify Request]/` request property `allOf` list
  - removed `subschema #1` from the `oneOf[subschema #2: OAuth Credential Verify Request -> subschema #3: OAuth Credential Verify Request]/` request property `allOf` list
  - removed `subschema #1` from the `oneOf[subschema #3: Passkey Credential Verify Request -> subschema #4: Passkey Credential Verify Request]/` request property `allOf` list
  - removed the request property `oneOf[subschema #1: Email OTP Credential Verify Request]/allOf[#/components/schemas/EmailOtpCredentialVerifyRequestFields]/clientPublicKey`
  - removed the request property `oneOf[subschema #1: Email OTP Credential Verify Request]/allOf[#/components/schemas/EmailOtpCredentialVerifyRequestFields]/otp`
  - added the new `ACCOUNT_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `AUTH_METHOD_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `CARDHOLDER_KYC_NOT_APPROVED` enum value to the `code` response property for the response status `400`
  - added the new `CUSTOMER_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `DAILY_VOLUME_LIMIT_EXCEEDED` enum value to the `code` response property for the response status `429`
  - added the new `DOCUMENTS_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the new `DOCUMENT_HOLDER_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `END_USER_TERMS_VERSION_NOT_FOUND` enum value to the `code` response property for the response status `400`
  - added the new `EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the new `INSUFFICIENT_FUNDS` enum value to the `code` response property for the response status `400`
  - added the new `NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `PAYMENT_DOCUMENT_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `PAYMENT_URL_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `PLATFORM_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `QUOTE_EXPIRED` enum value to the `code` response property for the response status `400`
  - added the new `QUOTE_RATE_UNAVAILABLE` enum value to the `code` response property for the response status `400`
  - added the new `REQUEST_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `SESSION_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `SMS_OTP_CREDENTIAL_ALREADY_EXISTS` enum value to the `code` response property for the response status `400`
  - added the new `STABLECOIN_AMOUNT_NOT_REPRESENTABLE` enum value to the `code` response property for the response status `400`
  - added the new `STABLECOIN_BURN_SOURCE_NOT_SUPPORTED` enum value to the `code` response property for the response status `400`
  - …34 more
- **2026-05-28** `d0bce562bffd`: 3 breaking, 10 warning, 2 info
  - added `subschema #1` to the `oneOf[subschema #1: Email OTP Credential Verify Request]/` request property `allOf` list
  - added `subschema #1` to the `oneOf[subschema #2: OAuth Credential Verify Request]/` request property `allOf` list
  - added `subschema #1` to the `oneOf[subschema #3: Passkey Credential Verify Request]/` request property `allOf` list
  - removed `#/components/schemas/AuthCredentialVerifyRequest` from the `oneOf[subschema #1: Email OTP Credential Verify Request]/` request property `allOf` list
  - removed `#/components/schemas/AuthCredentialVerifyRequest` from the `oneOf[subschema #2: OAuth Credential Verify Request]/` request property `allOf` list
  - removed `#/components/schemas/AuthCredentialVerifyRequest` from the `oneOf[subschema #3: Passkey Credential Verify Request]/` request property `allOf` list
  - removed the request property `oneOf[subschema #3: Passkey Credential Verify Request]/allOf[#/components/schemas/PasskeyCredentialVerifyRequestFields]/clientPublicKey`
  - added the new `REQUEST_ID_MISSING` enum value to the `code` response property for the response status `401`
  - added the new `UMA_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `WALLET_SIGNATURE_BODY_MISMATCH` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_INVALID` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_MALFORMED` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_MISSING` enum value to the `code` response property for the response status `401`
  - added the non-success response with the status `429`
  - added the optional property `allOf[#/components/schemas/AuthMethod]/credentialId` to the response with the `200` status
- **2026-04-27** `5b8a8161eeb3`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lightsparkdev/apis/grid-api/docs/auth/credentials/:id/verify/post.md) - [API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [Page](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/auth/credentials/:id/verify/post)
