---
title: "Retrieve an external key registration"
method: GET
path: "/organization/external_keys/{external_key_id}"
---

# Retrieve an external key registration

`GET /organization/external_keys/{external_key_id}`

## Request

- Base URL: `https://api.openai.com/v1`
- URL: `https://api.openai.com/v1/organization/external_keys/{external_key_id}`
- Auth: HTTP bearer

Retrieve a stored external key registration for the user's organization.

## Path parameters

- `external_key_id` string, required

## Response `200`

Success

- ExternalKeyResource
  - `object` string, required
  - `id` string, required
  - `type` string, required
  - `purpose` 'ekm' | 'psp_decryption'
  - `name` string, required
  - `api_project_ids` string[], required
  - `workspace_id` string, required
  - `created_at` integer, required
  - `role_arn` string
  - `external_id` string
  - `kms_arn` string
  - `workload_identity_project_number` string
  - `workload_identity_pool_id` string
  - `workload_identity_provider_id` string
  - `audience` string
  - `kms_project_id` string
  - `kms_key_ring_name` string
  - `kms_key_name` string
  - `kms_key_location` string
  - `kms_key_version` string
  - `tenant_id` string
  - `vault_uri` string
  - `key_name` string
  - `key_version` string

## Changes

> 429 revisions in range; 9 not diffed.

- **2026-10-28** `d7d75c18e834`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openai/apis/openapi/changes/organization/external_keys/:external_key_id/get.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) - [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/fd0373eb48e1?raw)