# List plan upgrades > List plan upgrades: TrueProxies customer API reference with the required scope, parameters, responses and code samples. Source: https://docs.trueproxies.com/api/operations/get_v1_services_id_upgrades/ `GET /v1/services/{id}/upgrades` **Fetch** ```js const url = 'https://api.trueproxies.com/v1/services/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/upgrades'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` **cURL** ```sh curl --request GET \ --url https://api.trueproxies.com/v1/services/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/upgrades \ --header 'Authorization: Bearer ' ``` Plans this service can move up to now: a faster speed or a longer term on the same service and login, never a downgrade. Each option shows the new plan’s price, the credit for unused time, the amount due and the new expiry; unavailable options carry a reason. To upgrade, create an invoice with POST /v1/invoices using this service\_id and the chosen offer\_key, then pay it within an hour. ## Authorizations - **[customerAPIKey](https://docs.trueproxies.com/api/#customerapikey)** ## Parameters ### Path Parameters - **id** required string format: uuid ### Query Parameters - **customer\_id** string format: uuid Owned sub-customer UUID. Resellers only; reads require reseller:read and writes reseller:purchase in addition to the operation scope. X-Customer-Id header is an alternative. Not allowed for me, wallet, trial, API keys, or reseller-management routes. ## Responses ### 200 Ok Media type: `application/json` object - **items** required Array\ A plan the service can move up to now, priced with credit for unused time. object - **available** required boolean - **credit\_cents** required Credit for unused time on the current plan. integer format: int64 - **currency** required string - **display\_name** required string - **due\_cents** required Amount to pay now, at least 50 cents. integer format: int64 - **new\_expires\_at** required When the upgraded plan would end if paid now; the new term starts at payment. string format: date-time - **offer\_key** required string - **price\_cents** required The new plan’s price for the payer. integer format: int64 - **reason** Why an option is not available now. string Allowed values: capacity\_unavailable - **speed\_bps** required integer format: int64 - **term** required string Allowed values: hour day week month ##### Example ```json { "items": [ { "currency": "USD", "reason": "capacity_unavailable", "term": "hour" } ] } ``` ### 400 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ``` ### 401 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ``` ### 403 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ``` ### 404 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ``` ### 409 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ``` ### 429 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ``` ### 500 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ``` ### 503 Error Media type: `application/json` object - **code** required string Allowed values: BAD\_REQUEST UNAUTHENTICATED FORBIDDEN NOT\_FOUND CONFLICT RATE\_LIMITED SERVICE\_UNAVAILABLE OFFER\_UNAVAILABLE CITY\_UNAVAILABLE CAPACITY\_UNAVAILABLE INVOICE\_NOT\_PAYABLE PROVIDER\_ERROR PIPE\_UNAVAILABLE TRIAL\_NOT\_ELIGIBLE EMAIL\_UNVERIFIED INTERNAL - **details** What a client needs to act on the error (ids, flags), never display text. object - ***key*** additional properties any - **message** required string ##### Example ```json { "code": "BAD_REQUEST" } ```