Renewals
Get a proxy renewal episode
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."
}CountRenewals
Returns the number of proxy renewal episodes in your workspace, optionally filtered by provider or status, so a list page can render a count without loading and counting every row.
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.