Skip to main content
GET
/
api
/
v4
/
secrets
/
{secretName}
cURL
curl --request GET \
  --url https://us.infisical.com/api/v4/secrets/{secretName} \
  --header 'Authorization: Bearer <token>'
{
  "secret": {
    "id": "<string>",
    "_id": "<string>",
    "workspace": "<string>",
    "environment": "<string>",
    "version": 123,
    "type": "<string>",
    "secretKey": "<string>",
    "secretValue": "<string>",
    "secretComment": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "secretValueHidden": true,
    "secretPath": "<string>",
    "secretReminderNote": "<string>",
    "secretReminderRepeatDays": 123,
    "skipMultilineEncoding": false,
    "actor": {
      "actorId": "<string>",
      "actorType": "<string>",
      "name": "<string>",
      "membershipId": "<string>",
      "groupId": "<string>"
    },
    "isRotatedSecret": true,
    "rotationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "slug": "<string>",
        "name": "<string>",
        "color": "<string>"
      }
    ],
    "secretMetadata": [
      {
        "key": "<string>",
        "value": ""
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

An access token in Infisical

Path Parameters

​
secretName
string
required

The name of the secret to get.

Query Parameters

​
projectId
string
required

The ID of the project to get the secret from.

​
environment
string

The slug of the environment to get the secret from.

​
secretPath
string
default:/

The path of the secret to get.

​
version
number

The version of the secret to get.

​
type
enum<string>
default:shared

The type of the secret to get.

Available options:
shared,
personal
​
viewSecretValue
enum<string>
default:true

Whether or not to retrieve the secret value.

Available options:
true,
false
​
expandSecretReferences
enum<string>
default:false

Whether or not to expand secret references.

Available options:
true,
false
​
include_imports
enum<string>
default:false

Weather to include imported secrets or not.

Available options:
true,
false

Response

Default Response

​
secret
object
required