# Get single authentication configuration by ID

**Documentation:** /reference/api-reference/auth-configs/getAuthConfigsByNanoid

Retrieves detailed information about a specific authentication configuration using its unique identifier.

---

## GET `/api/v3/auth_configs/{nanoid}`

**Endpoint:** `https://backend.composio.dev/api/v3/auth_configs/{nanoid}`

**Summary:** Get single authentication configuration by ID

Retrieves detailed information about a specific authentication configuration using its unique identifier.

### Authentication

**ApiKeyAuth** - API Key in `header` header `x-api-key` OR **UserApiKeyAuth** - API Key in `header` header `x-user-api-key`

### Path Parameters

- `nanoid` (string (authConfigId)) *(required)*: The unique identifier of the authentication configuration to retrieve

### Responses

#### 200 - Successfully fetched auth config

**Response Schema:**

- `id` (string (authConfigId)) *(required)*: The unique ID of the authentication configuration
- `uuid` (string) *(required)*: The UUID of the authentication configuration (for backward compatibility)
- `type` (enum: "default" | "custom") *(required)*: The type of the authentication configuration (custom or default)
- `toolkit` (object) *(required)*: Information about the associated integration
  - `slug` (string) *(required)*: The unique identifier of the integration app
  - `logo` (string) *(required)*: The URL to the integration app's logo image
  - `auth_guide_url` (string,null): URL to a guide page with authentication setup instructions
  - `auth_hint_url` (string,null): URL to a page where users can obtain or configure credentials
- `name` (string) *(required)*: The display name of the authentication configuration
- `auth_scheme` (enum: "OAUTH2" | "OAUTH1" | "API_KEY" | ...): The authentication scheme used (e.g., OAuth2, API Key, etc.)
- `is_composio_managed` (boolean): Whether this authentication configuration is managed by Composio or the user
- `credentials` (object): The authentication credentials (tokens, keys, etc.) - may be partially hidden for security
  - `[key: string]` (any)
- `proxy_config` (object,null)
- `status` (enum: "ENABLED" | "DISABLED") *(required)*: Current status of the authentication configuration
- `created_by` (string): The identifier of the user who created the auth config
- `created_at` (string): ISO 8601 date-time when the auth config was created
- `last_updated_at` (string): ISO 8601 date-time when the auth config was last updated
- `no_of_connections` (number) *(required)*: The number of active connections using this auth config
- `expected_input_fields` (array<object,null>): Fields expected during connection initialization
- `restrict_to_following_tools` (array<string>): Use tool_access_config instead. This field will be deprecated in the future.
- `tool_access_config` (object) *(required)*
  - `tools_for_connected_account_creation` (array<string>): Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes.
  - `tools_available_for_execution` (array<string>): The actions that the user can perform on the auth config. If passed, this will update the actions that the user can perform on the auth config.
- `shared_credentials` (object): [EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config
  - `[key: string]` (any)
- `is_enabled_for_tool_router` (boolean): Whether this auth config is enabled for tool router
- `deprecated_params` (object): DEPRECATED: This parameter will be removed in a future version.
  - `default_connector_id` (string,null) *(required)*: Deprecated: Default connector ID
  - `member_uuid` (string): Deprecated: Member UUID
  - `toolkit_id` (string): Deprecated: Toolkit ID
  - `expected_input_fields` (array<object>): Deprecated: Fields expected during connection initialization
    - Array items:
      - `[key: string]` (any)

**Example Response:**

```json
{
  "id": "string",
  "uuid": "string",
  "type": "default",
  "toolkit": {
    "slug": "string",
    "logo": "string",
    "auth_guide_url": null,
    "auth_hint_url": null
  },
  "name": "string",
  "auth_scheme": "OAUTH2",
  "is_composio_managed": true,
  "credentials": {
    "key": null
  },
  "proxy_config": null,
  "status": "ENABLED",
  "created_by": "string",
  "created_at": "string",
  "last_updated_at": "string",
  "no_of_connections": 1,
  "expected_input_fields": [
    null
  ],
  "restrict_to_following_tools": [
    "string"
  ],
  "tool_access_config": {
    "tools_for_connected_account_creation": [],
    "tools_available_for_execution": []
  },
  "shared_credentials": {
    "key": null
  },
  "is_enabled_for_tool_router": true,
  "deprecated_params": {
    "default_connector_id": null,
    "member_uuid": "string",
    "toolkit_id": "string",
    "expected_input_fields": [
      {
        "key": "..."
      }
    ]
  }
}
```

#### 400 - Bad request - Invalid auth config ID format

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Unauthorized - Authentication required

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 404 - Not found - Auth configuration does not exist

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 500 - Internal server error - Something went wrong on the server

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X GET "https://backend.composio.dev/api/v3/auth_configs/string" \
  -H "x-api-key: YOUR_API_KEY"
```