---
title: "Get credential by ID or name"
method: GET
path: "/credentials/{id_or_name}"
tags: ["Credentials"]
---

# Get credential by ID or name

`GET /credentials/{id_or_name}`

Retrieve a credential by its ID or name. Credential values are not returned.

## Path parameters

- `id_or_name` string, required

## Response `200`

Credential details

- Credential — A stored credential for automatic re-authentication
  - `id` string, required — Unique identifier for the credential
  - `name` string, required — Unique name for the credential within the project
  - `domain` string, required — Target domain this credential is for
  - `created_at` string, date-time, required — When the credential was created
  - `updated_at` string, date-time, required — When the credential was last updated
  - `has_values` boolean — Whether this credential has stored values (email, password, etc.)
  - `has_totp_secret` boolean — Whether this credential has a TOTP secret configured for automatic 2FA
  - `value_keys` string[] — The field names stored in this credential's values (e.g., username, password). Values themselves are never returned. Included on single-credential responses (create, get by id or name, update); omitted from list responses.
  - `sso_provider` string, nullable — If set, indicates this credential should be used with the specified SSO provider (e.g., google, github, microsoft). When the target site has a matching SSO button, it will be clicked first before filling credential values on the identity provider's login page.
  - `totp_code` string — Current 6-digit TOTP code. Only included in create/update responses when totp_secret was just set.
  - `totp_code_expires_at` string, date-time — When the totp_code expires. Only included when totp_code is present.

## Other responses

- `401` — Unauthorized – missing or invalid authorization token
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/kernel/apis/kernel-api.md) · [All operations](https://skmtc.net/kernel/apis/kernel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/kernel-api/revisions/9e8ce9fcf5e1/schema)