---
title: "Get Connection Proxy Info"
method: GET
path: "/api/connections/{id}/proxy/info"
tags: ["Connections"]
---

# Get Connection Proxy Info

`GET /api/connections/{id}/proxy/info`

Returns the proxy contract for a connection.

Use this endpoint before calling
[`POST /api/connections/{id}/proxy`](../../../../../api-reference/connections/execute-proxy)
when you need to build requests programmatically. The response shows:

- the inherited base URL that all proxied requests are sent to
- locked headers and query parameters that are attached automatically
- blocked request and response headers
- allowed HTTP methods and body shapes
- timeout, rate-limit, and payload-size limits

Sensitive inherited header and query values are redacted in the response. The
contract is still useful for discovering which keys are fixed by the
connection, even though their raw values are not exposed.

## Path parameters

- `id` string, uuid, required — Unique identifier of the connection whose proxy contract should be returned.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- GetConnectionProxyInfoEnvelope
  - `data` ConnectionProxyInfoResponse
    - `backendType` string — Connection backend identifier (e.g. hubspot, salesforce).
    - `connectionId` string, uuid — Unique identifier of the connection the proxy contract applies to.
    - `inheritedBase` ConnectionProxyInheritedBase
      - `baseUrl` string — Base URL all proxied requests are sent to. Caller-supplied paths are appended to this URL.
      - `lockedHeaders` ConnectionProxyLockedHeader[], nullable — Headers that are always attached to proxied requests. Sensitive values are redacted.
        - `name` string — Header name.
        - `redacted` boolean — True when the header value was redacted before returning it.
        - `value` string — Header value. Replaced with [REDACTED] if the header is sensitive.
      - `lockedQuery` object, nullable — Query parameters that are always attached to proxied requests. Values are redacted.
    - `mergeRules` ConnectionProxyMergeRules
      - `headers` string — How caller-supplied headers are merged with the connection's inherited headers.
      - `query` string — How caller-supplied query parameters are merged with the connection's inherited query parameters.
    - `requestContract` ConnectionProxyContract
      - `allowedMethods` string[], nullable — HTTP methods the proxy accepts.
      - `blockedRequestHeaders` string[], nullable — Headers the proxy strips from caller-supplied requests before forwarding.
      - `blockedResponseHeaders` string[], nullable — Headers the proxy strips from upstream responses before returning them.
      - `bodyTypes` string[], nullable — Supported JSON types for request.body (e.g. object, string, null).
      - `maxRequestBodyBytes` integer — Maximum accepted request body size in bytes.
      - `maxResponseBodyBytes` integer — Maximum response body size in bytes. Larger responses are truncated.
      - `pathRule` string — Rule the caller-supplied path must satisfy.
      - `queryModes` string[], nullable — Supported request query inputs. Use query for structured URL-encoded parameters or rawQuery for exact passthrough.
      - `queryValueTypes` string[], nullable — Supported value types for request.query.
      - `rateLimitPerMinute` integer — Maximum proxied requests per minute per connection before the proxy returns 429.
      - `rawQueryRule` string — How request.rawQuery is appended and who is responsible for encoding.
      - `timeoutMs` integer — Per-request timeout in milliseconds.
    - `stats` ConnectionProxyStats
      - `callsLast24h` integer — Total backend API calls made through this connection (including non-proxy calls) over the last 24 hours.
      - `lastProxyCallAt` string, date-time, nullable — Timestamp of the most recent proxy call, or null if none have occurred.
      - `proxy2xxLast24h` integer — Proxy calls that returned a 2xx status in the last 24 hours.
      - `proxy4xxLast24h` integer — Proxy calls that returned a 4xx status in the last 24 hours.
      - `proxy5xxLast24h` integer — Proxy calls that returned a 5xx status in the last 24 hours.
      - `proxyCallsLast24h` integer — Proxy calls made in the last 24 hours.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/5e9bcd4cfb2d/schema)