---
title: "GET /proxies"
method: GET
path: "/proxies"
tags: ["Proxies"]
---

# GET /proxies

`GET /proxies`

## Query parameters

- `id` string[], nullable
- `name` string, nullable
- `page` integer, nullable
- `start` string, nullable
- `size` integer, nullable

## Response `200`

Success

- ProxyPaginatedList
  - `pagination` Pagination
    - `total_items` integer, nullable
    - `page_number` integer, nullable
    - `page_size` integer, nullable
    - `total_pages` integer, nullable
    - `after` string, nullable
    - `next` string, nullable
  - `data` Proxy[], nullable
    - `id` string, uuid
    - `key` string, nullable
    - `tenant_id` string, uuid
    - `name` string, nullable
    - `destination_url` string, nullable
    - `state` string, nullable
    - `request_reactor_id` string, uuid, nullable
    - `response_reactor_id` string, uuid, nullable
    - `require_auth` boolean
    - `request_transform` ProxyTransform
      - `type` string, nullable
      - `code` string, nullable
      - `matcher` string, nullable
      - `expression` string, nullable
      - `replacement` string, nullable
      - `options` ProxyTransformOptions
        - `token` CreateTokenRequest
          - `id` string, nullable
          - `type` string, nullable
          - `data` unknown
          - `encrypted` string, nullable
          - `privacy` Privacy
            - `classification` string, nullable
            - `impact_level` string, nullable
            - `restriction_policy` string, nullable
          - `metadata` object, nullable
          - `search_indexes` string[], nullable
          - `fingerprint_expression` string, nullable
          - `mask` unknown
          - `deduplicate_token` boolean, nullable
          - `expires_at` string, nullable
          - `containers` string[], nullable
          - `token_intent_id` string, nullable
          - `owner_merchant_id` string, uuid, nullable
        - `identifier` string, nullable
        - `value` string, nullable
        - `location` string, nullable
        - `runtime` Runtime
          - `image` string, nullable
          - `dependencies` object, nullable
          - `resolutions` object, nullable
          - `warm_concurrency` integer, nullable
          - `timeout` integer, nullable
          - `resources` string, nullable
          - `permissions` string[], nullable
    - `response_transform` ProxyTransform
      - `type` string, nullable
      - `code` string, nullable
      - `matcher` string, nullable
      - `expression` string, nullable
      - `replacement` string, nullable
      - `options` ProxyTransformOptions
        - `token` CreateTokenRequest
          - `id` string, nullable
          - `type` string, nullable
          - `data` unknown
          - `encrypted` string, nullable
          - `privacy` Privacy
            - `classification` string, nullable
            - `impact_level` string, nullable
            - `restriction_policy` string, nullable
          - `metadata` object, nullable
          - `search_indexes` string[], nullable
          - `fingerprint_expression` string, nullable
          - `mask` unknown
          - `deduplicate_token` boolean, nullable
          - `expires_at` string, nullable
          - `containers` string[], nullable
          - `token_intent_id` string, nullable
          - `owner_merchant_id` string, uuid, nullable
        - `identifier` string, nullable
        - `value` string, nullable
        - `location` string, nullable
        - `runtime` Runtime
          - `image` string, nullable
          - `dependencies` object, nullable
          - `resolutions` object, nullable
          - `warm_concurrency` integer, nullable
          - `timeout` integer, nullable
          - `resources` string, nullable
          - `permissions` string[], nullable
    - `request_transforms` ProxyTransform[], nullable
      - `type` string, nullable
      - `code` string, nullable
      - `matcher` string, nullable
      - `expression` string, nullable
      - `replacement` string, nullable
      - `options` ProxyTransformOptions
        - `token` CreateTokenRequest
          - `id` string, nullable
          - `type` string, nullable
          - `data` unknown
          - `encrypted` string, nullable
          - `privacy` Privacy
            - `classification` string, nullable
            - `impact_level` string, nullable
            - `restriction_policy` string, nullable
          - `metadata` object, nullable
          - `search_indexes` string[], nullable
          - `fingerprint_expression` string, nullable
          - `mask` unknown
          - `deduplicate_token` boolean, nullable
          - `expires_at` string, nullable
          - `containers` string[], nullable
          - `token_intent_id` string, nullable
          - `owner_merchant_id` string, uuid, nullable
        - `identifier` string, nullable
        - `value` string, nullable
        - `location` string, nullable
        - `runtime` Runtime
          - `image` string, nullable
          - `dependencies` object, nullable
          - `resolutions` object, nullable
          - `warm_concurrency` integer, nullable
          - `timeout` integer, nullable
          - `resources` string, nullable
          - `permissions` string[], nullable
    - `response_transforms` ProxyTransform[], nullable
      - `type` string, nullable
      - `code` string, nullable
      - `matcher` string, nullable
      - `expression` string, nullable
      - `replacement` string, nullable
      - `options` ProxyTransformOptions
        - `token` CreateTokenRequest
          - `id` string, nullable
          - `type` string, nullable
          - `data` unknown
          - `encrypted` string, nullable
          - `privacy` Privacy
            - `classification` string, nullable
            - `impact_level` string, nullable
            - `restriction_policy` string, nullable
          - `metadata` object, nullable
          - `search_indexes` string[], nullable
          - `fingerprint_expression` string, nullable
          - `mask` unknown
          - `deduplicate_token` boolean, nullable
          - `expires_at` string, nullable
          - `containers` string[], nullable
          - `token_intent_id` string, nullable
          - `owner_merchant_id` string, uuid, nullable
        - `identifier` string, nullable
        - `value` string, nullable
        - `location` string, nullable
        - `runtime` Runtime
          - `image` string, nullable
          - `dependencies` object, nullable
          - `resolutions` object, nullable
          - `warm_concurrency` integer, nullable
          - `timeout` integer, nullable
          - `resources` string, nullable
          - `permissions` string[], nullable
    - `application_id` string, uuid, nullable
    - `configuration` object, nullable
    - `proxy_host` string, nullable
    - `timeout` integer, nullable
    - `disable_detokenization` boolean
    - `client_certificate` string, nullable
    - `requested` RequestedProxy
      - `proxy` PendingProxy
        - `destination_url` string, nullable
        - `configuration` object, nullable
        - `require_auth` boolean
        - `request_transforms` ProxyTransform[], nullable
          - `type` string, nullable
          - `code` string, nullable
          - `matcher` string, nullable
          - `expression` string, nullable
          - `replacement` string, nullable
          - `options` ProxyTransformOptions
            - `token` CreateTokenRequest
              - …
            - `identifier` string, nullable
            - `value` string, nullable
            - `location` string, nullable
            - `runtime` Runtime
              - …
        - `response_transforms` ProxyTransform[], nullable
          - `type` string, nullable
          - `code` string, nullable
          - `matcher` string, nullable
          - `expression` string, nullable
          - `replacement` string, nullable
          - `options` ProxyTransformOptions
            - `token` CreateTokenRequest
              - …
            - `identifier` string, nullable
            - `value` string, nullable
            - `location` string, nullable
            - `runtime` Runtime
              - …
      - `error_code` string, nullable
      - `error_message` string, nullable
      - `error_details` object, nullable
    - `created_by` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `modified_by` string, uuid, nullable
    - `modified_at` string, date-time, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/basistheory/apis/basis-theory-api.md) · [All operations](https://skmtc.net/basistheory/apis/basis-theory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/basistheory/basis-theory-api/revisions/cbb8e098b560/schema)