> ## Documentation Index
> Fetch the complete documentation index at: https://doubledata.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage proxy credentials

> Create, read, limit, and delete Residential, Datacenter, and Mobile proxy credentials.

A credential is the username and password you use to connect to the Residential, Datacenter, or Mobile network. Your API key selects the workspace, so you never send an organization ID.

## List credentials

```bash theme={null}
curl https://app.proxy.doubledata.com/api/v1/proxies \
  -H "Authorization: Bearer $DOUBLEDATA_API_KEY"
```

The list includes each credential's product, status, funding source, traffic used, and limits. It never includes passwords.

## Create a credential

> [!WARNING]
>
> This creates a live credential. Traffic sent through it uses your GB package or organization balance.

```bash theme={null}
curl -X POST https://app.proxy.doubledata.com/api/v1/proxies \
  -H "Authorization: Bearer $DOUBLEDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Price monitor", "proxy_type": "residential"}'
```

* `name` is required and can be up to 24 characters.
* `proxy_type` is `residential` (default), `datacenter`, or `mobile`.
* You need a GB package for that product or a positive balance. Otherwise the request returns `402 insufficient_balance`.

The `201` response includes the username, password, and gateway details. Store the password as a secret.

## Read a password

```bash theme={null}
curl https://app.proxy.doubledata.com/api/v1/proxies/resi_3f9a1c2b7d4e8f60 \
  -H "Authorization: Bearer $DOUBLEDATA_API_KEY"
```

Use the base username. Add country, city, and session parameters only when you connect. See [connection formats](https://doubledata.mintlify.site/guides/proxy-formats.md).

## Limit traffic

Cap what a credential can use. This is useful when you give a credential to a teammate, a customer, or an AI agent. Limits are in MB, and `0` removes a limit. Daily, weekly, and monthly periods reset in UTC.

> [!WARNING]
>
> This changes a live credential. Requests stop when a limit is reached.

```bash theme={null}
curl -X PUT https://app.proxy.doubledata.com/api/v1/proxies/resi_3f9a1c2b7d4e8f60/limits \
  -H "Authorization: Bearer $DOUBLEDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_limit_mb": 50000, "daily_limit_mb": 5000}'
```

Fields you omit keep their current value. `GET` on the same path returns the limits, the consumption in each period, and reset times.

## Delete a credential

> [!WARNING]
>
> Deletion is permanent. Connections that use the credential stop working immediately.

```bash theme={null}
curl -X DELETE https://app.proxy.doubledata.com/api/v1/proxies/resi_3f9a1c2b7d4e8f60 \
  -H "Authorization: Bearer $DOUBLEDATA_API_KEY"
```

A successful deletion returns `204`. Static ISP subscriptions are not managed here; use the [Static ISP endpoints](https://doubledata.mintlify.site/api-reference/isp.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.