Goldmine
Renewals

Get a proxy renewal episode

POST
/proxies.v1.Proxies/GetRenewal

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

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

application/json

curl -X POST "https://loading/proxies.v1.Proxies/GetRenewal" \  -H "Content-Type: application/json" \  -d '{    "renewalId": "AY+MJmZmfu6P/05OTk5OTg=="  }'
{
  "renewal": {
    "id": "AY+MJmZmfu6P/05OTk5OTg==",
    "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
    "providerId": "AY+MIZmZfu6P/05OTk5OTg==",
    "status": "RENEWING",
    "endpointIds": [
      "10.0.0.1:8080",
      "10.0.0.2:8080"
    ],
    "attempts": 1,
    "spendCents": "2500",
    "createdAt": "2026-06-29T09:00:00Z",
    "updatedAt": "2026-06-29T09:00:00Z"
  }
}
{
  "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": "not_found",
  "message": "The requested resource does not exist in this workspace."
}
{
  "code": "resource_exhausted",
  "message": "The request was rate limited. Slow down and retry later."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}