---
title: "Get an API connector"
method: GET
path: "/v2/api-connectors/{apiConnectorId}"
tags: ["API connectors"]
---

# Get an API connector

`GET /v2/api-connectors/{apiConnectorId}`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/api-connectors/{apiConnectorId}`
- Auth: HTTP bearer

This endpoint returns full details for a single API connector, including its request parameters and configuration. For more information on API connectors, see [Configure API credentials and connectors in Sigma](https://help.sigmacomputing.com/docs/configure-api-credentials-and-connectors-in-sigma).

### Usage notes
- Only returns API connectors that the user making this request has at least **Can view** access to.
- Retrieve the **apiConnectorId** by calling the [/v2/api-connectors](https://help.sigmacomputing.com/reference/list-api-connectors) endpoint.

### Usage scenarios
- **Connector inspection:** Retrieve the full configuration of a connector for display or validation before use.
- **Connector duplication:** Read an existing connector's configuration to use as the basis for a new one.

## Path parameters

- `apiConnectorId` string, required

## Response `200`

The response body.

- ApiConnectorsGetApiConnectorResponse200
  - `apiConnectorId` string, required: Unique identifier of the API connector.
  - `name` string, required: Display name of the connector.
  - `params` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaParams, required
    - `method` 'GET' | 'POST' | 'DELETE' | 'PATCH' | 'PUT' | 'OPTIONS' | 'HEAD', required: HTTP method to invoke.
    - `url` string, required: Request URL. Must resolve to a hostname matching the associated credential's allowlist.
    - `headers` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaParamsHeadersItems[], required: Static or dynamic request headers.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `pathParams` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaParamsPathParamsItems[], required: Path parameter placeholders resolved into the URL.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `queryParams` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaParamsQueryParamsItems[], required: Query string parameters.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
    - `body` string, required: Raw request body template.
    - `bodyParams` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaParamsBodyParamsItems[], required: Dynamic parameters extracted from `body`.
      - `key` string, required
      - `mode` 'static' | 'dynamic', required
      - `value` string, nullable
      - `type` 'array' | 'boolean' | 'number' | 'object' | 'raw' | 'string'
      - `shape` union
        - ParamShapeNode0
          - `type` ParamShapeNodeOneOf0TypeItems[], required
        - ParamShapeNode1
          - `type` ParamShapeNodeOneOf1TypeItems[], required
        - ParamShapeNode2
          - `type` ParamShapeNodeOneOf2TypeItems[], required
        - ParamShapeNode3
          - `type` ParamShapeNodeOneOf3TypeItems[], required
          - `properties` object, required
        - ParamShapeNode4
          - `type` ParamShapeNodeOneOf4TypeItems[], required
          - `items` ParamShapeNode, required (recursive)
        - object
  - `config` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaConfig, required
    - `timeout` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaConfigTimeout, required: Per-request timeout configuration.
      - `requestSec` number, double, required
    - `retry` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaConfigRetry, required: Retry policy. `retryableStatusCodes` are HTTP codes that should trigger a retry.
      - `maxRetries` number, double, required
      - `retryableStatusCodes` number[], required
    - `redirects` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaConfigRedirects, required: HTTP redirect handling.
      - `maxRedirects` number, double, required
    - `rateLimit` V2ApiConnectorsApiConnectorIdGetResponsesContentApplicationJsonSchemaConfigRateLimit, required: Rate limit applied to outbound requests from this connector.
      - `maxRequestsPerWindow` number, double, required
  - `createdBy` string, required: The identifier of the user who created this object.
  - `updatedBy` string, required: The identifier of the user or process that last updated this object.
  - `createdAt` string, date-time, required: When the object was created.
  - `updatedAt` string, date-time, required: When the object was last updated.
  - `description` string: Human-readable description.
  - `authId` string, nullable: Identifier of the API credential (`apiCredentialId`) used to authenticate requests. `null` if unauthenticated.

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)