Goldmine
Renewals

List proxy renewal episodes

POST
/proxies.v1.Proxies/ListRenewals

Returns the proxy renewal episodes in your workspace, optionally filtered by provider or status. Results are paginated; pass an empty cursor for the first page and follow the returned cursor for subsequent pages.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/proxies.v1.Proxies/ListRenewals" \  -H "Content-Type: application/json" \  -d '{    "limit": 50,    "providerId": "AY+MIZmZfu6P/05OTk5OTg=="  }'
{
  "renewals": [
    {
      "id": "AY+MJmZmfu6P/05OTk5OTg==",
      "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
      "providerId": "AY+MIZmZfu6P/05OTk5OTg==",
      "status": "HALTED",
      "endpointIds": [
        "10.0.0.1:8080"
      ],
      "attempts": 3,
      "spendCents": "0",
      "lastError": "insufficient balance",
      "createdAt": "2026-06-28T09:00:00Z",
      "updatedAt": "2026-06-28T09:05:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ=="
}
{
  "code": "invalid_argument",
  "message": "The request was malformed, such as a missing required field or an unparseable cursor."
}
{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "resource_exhausted",
  "message": "The request was rate limited. Slow down and retry later."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}

GetRenewal

Returns a single provider renewal episode by id, showing its status, the endpoint batch it renews, and spend so far.

ImportProxyList

Turns an uploaded list of proxies into ready-to-use sessions in one call. It creates a new provider-less pool by name and inserts one session per row directly into it - there is no provider and no existing-pool option. Each row is processed independently and the response reports per-row success or error.