---
updatedAt: 2026-07-31T12:37:05.000Z
---

# Get Agent by ID

Retrieves a specific agent by its unique identifier.

**Required Entitlements** (at least one): tenantAdmin, readAgents, writeAgents, manageAgentStatus, agentOwner

Display names for createdBy and owners are fetched and returned if exist in the tenant.

OAuth clients are fetched dynamically once Agent Id gets associated with OIDC Applications.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "description": "AI Agents",
    "title": "AI Agents"
  },
  "servers": [
    {
      "url": "https://{tenanturl}",
      "variables": {
        "tenanturl": {
          "default": "{tenant_url}",
          "description": "URL of your IBM Security Verify tenant"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Agent management",
      "description": "SCIM 2.0 compliant agent operations"
    }
  ],
  "paths": {
    "/v1.0/Agents/{id}": {
      "get": {
        "tags": [
          "Agent management"
        ],
        "summary": "Get Agent by ID",
        "description": "Retrieves a specific agent by its unique identifier.\n\n**Required Entitlements** (at least one): tenantAdmin, readAgents, writeAgents, manageAgentStatus, agentOwner\n\nDisplay names for createdBy and owners are fetched and returned if exist in the tenant.\n\nOAuth clients are fetched dynamically once Agent Id gets associated with OIDC Applications.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Unique identifier of the agent (UUID)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Agent retrieved successfully",
            "content": {}
          },
          "401": {
            "description": "Unauthorized - Authentication required",
            "content": {}
          },
          "403": {
            "description": "Forbidden - Insufficient permissions (CSINH2501E)",
            "content": {}
          },
          "404": {
            "description": "Not Found - Agent not found (CSINH2001E)",
            "content": {}
          },
          "500": {
            "description": "Internal Server Error (CSINH1000E)",
            "content": {}
          }
        },
        "x-category": "AI Agents",
        "x-publicAPI": "true"
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-explorer-enabled": false
}
```