---
title: "Get single authentication configuration by ID"
method: GET
path: "/api/v3.1/auth_configs/{nanoid}"
tags: ["Auth Configs"]
---

# Get single authentication configuration by ID

`GET /api/v3.1/auth_configs/{nanoid}`

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

## Path parameters

- `nanoid` string, authConfigId, required — The unique identifier of the authentication configuration to retrieve

## Response `200`

Successfully fetched auth config

- object
  - `id` string, authConfigId, required — The unique ID of the authentication configuration
  - `uuid` string, required — The UUID of the authentication configuration (for backward compatibility)
  - `type` '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, nullable — URL to a guide page with authentication setup instructions
    - `auth_hint_url` string, nullable — URL to a page where users can obtain or configure credentials
  - `name` string, required — The display name of the authentication configuration
  - `auth_scheme` 'OAUTH2' | 'OAUTH1' | 'API_KEY' | 'BASIC' | 'BILLCOM_AUTH' | 'BEARER_TOKEN' | 'GOOGLE_SERVICE_ACCOUNT' | 'NO_AUTH' | 'BASIC_WITH_JWT' | 'CALCOM_AUTH' | 'SERVICE_ACCOUNT' | 'SAML' | 'DCR_OAUTH' | 'S2S_OAUTH2' — 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
  - `proxy_config` object, nullable
    - `proxy_url` string, uri, required — The url of the auth proxy
    - `proxy_auth_key` string — The auth key for the auth proxy
  - `status` '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` unknown[] — Fields expected during connection initialization
    - unknown
  - `restrict_to_following_tools` string[] — Use tool_access_config instead. This field will be deprecated in the future.
  - `tool_access_config` object, required
    - `tools_for_connected_account_creation` 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` 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
  - `is_enabled_for_tool_router` boolean — Whether this auth config is enabled for tool router

## Other responses

- `400` — Bad request - Invalid auth config ID format
- `401` — Unauthorized - Authentication required
- `404` — Not found - Auth configuration does not exist
- `500` — Internal server error - Something went wrong on the server

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)