# Retrieve pending renewal status (https://developer.godaddy.com/en/docs/references/rest/ans/get-server-certificate-renewal-status)

---
title: Retrieve pending renewal status
description: >-
  Returns current server certificate renewal status for the agent, if one
  exists.
full: true
---

Full description

Returns current server certificate renewal status for the agent, if one exists. Use to check ACME verification progress, poll for certificate issuance, retrieve challenges if the POST response was lost, or get the TLSA record after completion.

## GET /v1/agents/{agentId}/certificates/server/renewal

Retrieve pending renewal status

Returns current server certificate renewal status for the agent, if one exists. Use to check ACME verification progress, poll for certificate issuance, retrieve challenges if the POST response was lost, or get the TLSA record after completion.

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `agentId` | string | yes | Unique identifier of the agent (UUID format) |

### Responses

**200** — Renewal found

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/RenewalStatus`

**401** — Authentication failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**403** — Authorization failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**404** — No renewal exists for this agent (never submitted, or previously cancelled/deleted)

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**500** — Internal server error

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`