> ## Documentation Index
> Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.

# Get an API key

> Read one API key by id, including its role bindings, permission mode and explicit permissions. Returns your own keys; organization admins may read any key in the organization. The secret is never returned. An id that does not exist, belongs to another organization, or belongs to another member all answer 404 api_key_not_found, so the response cannot be used to probe for keys.



## OpenAPI

````yaml GET /api/v1/api-keys/{id}
openapi: 3.1.0
info:
  title: LangWatch API
  description: LangWatch openapi spec
  version: 1.0.0
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/v1/api-keys/{id}:
    get:
      tags:
        - API Keys
      summary: Get an API key
      description: >-
        Read one API key by id, including its role bindings, permission mode and
        explicit permissions. Returns your own keys; organization admins may
        read any key in the organization. The secret is never returned. An id
        that does not exist, belongs to another organization, or belongs to
        another member all answer 404 api_key_not_found, so the response cannot
        be used to probe for keys.
      operationId: getApiKey
      parameters:
        - in: path
          name: id
          schema:
            type: string
            minLength: 1
          required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    minLength: 1
                  name:
                    type: string
                  description:
                    type:
                      - string
                      - 'null'
                  createdAt:
                    type: string
                    format: date-time
                  expiresAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: 'null'
                  lastUsedAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: 'null'
                  revokedAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: 'null'
                  roleBindings:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          minLength: 1
                        role:
                          type: string
                          enum:
                            - ADMIN
                            - MEMBER
                            - VIEWER
                            - CUSTOM
                        scopeType:
                          type: string
                          enum:
                            - ORGANIZATION
                            - TEAM
                            - PROJECT
                        scopeId:
                          type: string
                          minLength: 1
                      required:
                        - id
                        - role
                        - scopeType
                        - scopeId
                      additionalProperties: false
                  keyType:
                    type: string
                    enum:
                      - personal
                      - service
                  assignedToUserId:
                    type:
                      - string
                      - 'null'
                  createdByUserId:
                    type:
                      - string
                      - 'null'
                  permissionMode:
                    type: string
                  permissions:
                    type: array
                    items:
                      type: string
                      pattern: ^[a-z][a-zA-Z0-9_-]*:[a-z][a-zA-Z0-9_-]*$
                  bindings:
                    type: array
                    items:
                      type: object
                      properties:
                        role:
                          type: string
                          enum:
                            - ADMIN
                            - MEMBER
                            - VIEWER
                            - CUSTOM
                        scopeType:
                          type: string
                          enum:
                            - ORGANIZATION
                            - TEAM
                            - PROJECT
                        scopeId:
                          type: string
                          minLength: 1
                      required:
                        - role
                        - scopeType
                        - scopeId
                      additionalProperties: false
                required:
                  - id
                  - name
                  - description
                  - createdAt
                  - expiresAt
                  - lastUsedAt
                  - revokedAt
                  - roleBindings
                  - keyType
                  - assignedToUserId
                  - createdByUserId
                  - permissionMode
                  - permissions
                  - bindings
                additionalProperties: false
        '401':
          description: Invalid or missing API key token
          content: {}
        '403':
          description: Insufficient permissions (requires organization:view)
          content: {}
        '404':
          description: API key not found (api_key_not_found)
          content: {}
      security:
        - admin_api_key: []
components:
  securitySchemes:
    project_api_key:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: >-
        Project API key for sending traces and accessing project-scoped
        resources. Format: sk-lw-... (no underscore). Obtain one by creating a
        project via the Admin API or the LangWatch UI.
    admin_api_key:
      type: http
      scheme: bearer
      description: >-
        Admin API key for organization-level operations (managing projects, API
        keys). Create one in Settings > API Keys or via POST /api/api-keys.
        Format: sk-lw-{id}_{secret}.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.