List Keys
Endpoint
GET /apiops/projects/{projectName}/keys/
Authentication
Requires a Personal API Access Token.
Header
Authorization: Bearer YOUR_TOKEN
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer {token} | Yes |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| projectName | string | Yes | Project name |
Query Parameters
None.
Response
Success Response (200 OK)
{
"status": "SUCCESS",
"resultList": [
{
"id": "key-id-123",
"name": "my-key",
"description": "Key for API encryption",
"projectId": "project-id",
"keyType": "SECRET_KEY",
"algorithm": "AES",
"cryptoKeyInfoEnvironmentList": [
{
"environmentName": "production",
"alias": "my-key-alias",
"source": null
}
]
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
| status | string | Response status: SUCCESS or FAILURE |
| resultList | array[object] | List of keys |
Key Object
| Field | Type | Description |
|---|---|---|
| id | string | Key ID (internal identifier) |
| name | string | Key name |
| description | string | Key description |
| projectId | string | Project ID where key belongs |
| keyType | string | Key type: SECRET_KEY, PRIVATE_KEY, or PUBLIC_KEY |
| algorithm | string | Symmetric key algorithm — populated when keyType is SECRET_KEY: AES, DES, DESede, or RSA. null for PRIVATE_KEY / PUBLIC_KEY. |
| cryptoKeyInfoEnvironmentList | array[object] | List of key environments |
Key Environment Object
| Field | Type | Description |
|---|---|---|
| environmentName | string | Environment name where the key is deployed |
| alias | string | Key alias (optional identifier) |
| source | string | Internal origin marker for this environment entry, set during export/import merges. Not settable through the create/update request bodies. |
Note: The key material itself (content) is never returned by this endpoint — it is write-only, accepted on Create Key / Update Key but not echoed back here or by Get Key. The environment entry also carries environmentName directly; no separate lookup against environmentId is needed.
cURL Example
curl -X GET \
"https://demo.apinizer.com/apiops/projects/MyProject/keys/" \
-H "Authorization: Bearer YOUR_TOKEN"
Notes and Warnings
-
Key Content is never returned:
- The key material (
content) is write-only — it is accepted by Create Key / Update Key but is not included in this response - To retrieve the raw material itself, use Export Key File (subject to
SECRETS+EXPORT_IMPORTpermission)
- The key material (
-
Multiple Environments:
- Each key can be deployed to multiple environments
- Each environment has separate key configuration
-
Environment Name:
- Response carries
environmentNamedirectly on each environment entry — no separate lookup is needed algorithmis only populated forSECRET_KEYkeys
- Response carries
Permissions
User must have any permission in the project (read access).
Related Documentation
- Get Key - Get a specific key
- Create Key - Create a new key