---
title: "Get a HMAC-auth credential"
method: GET
path: "/v2/control-planes/{controlPlaneId}/core-entities/hmac-auths/{HMACAuthId}"
tags: ["HMAC-auth credentials"]
---

# Get a HMAC-auth credential

`GET /v2/control-planes/{controlPlaneId}/core-entities/hmac-auths/{HMACAuthId}`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v2/control-planes/{controlPlaneId}/core-entities/hmac-auths/{HMACAuthId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Get a HMAC-auth credential using ID.

## Response `200`

Successfully fetched HMAC-auth credential

- HMACAuth
  - `consumer` object, nullable
    - `id` string
  - `created_at` integer, nullable: Unix epoch when the resource was created.
  - `id` string, nullable: A string representing a UUID (universally unique identifier).
  - `secret` string, nullable
  - `tags` string[], nullable: A set of strings representing tags.
  - `username` string, required

## Other responses

- `401`: Unauthorized
- `404`: Resource does not exist

## Changes

- **2025-07-22** `76b0fefddb0d`: 1 breaking
  - the response property `tags` became nullable for the status `200`

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v2/control-planes/:controlPlaneId/core-entities/hmac-auths/:HMACAuthId/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)