> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HCHttpCallRequestGetRetryDelay

> HCHttpCallRequestGetRetryDelay

# HCHttpCallRequestGetRetryDelay

Gets the HTTP retry delay in seconds. The default and minimum delay is 2 seconds.

## Syntax

```cpp theme={null}
HRESULT HCHttpCallRequestGetRetryDelay(  
         HCCallHandle call,  
         uint32_t* retryDelayInSeconds  
)  
```

### Parameters

*call*   \_In\_opt\_\
Type: HCCallHandle

The handle of the HTTP call. Pass nullptr to get the default for future calls.

*retryDelayInSeconds*   \_In\_\
Type: uint32\_t\*

The retry delay in seconds.

### Return value

Type: HRESULT

Result code for this API operation. Possible values are S\_OK, E\_INVALIDARG, or E\_FAIL.

## Remarks

Retries are delayed using an exponential back off. By default, it will delay 2 seconds then the next retry will delay 4 seconds, then 8 seconds, and so on up to a max of 1 min until either the call succeeds or the HTTP timeout window is reached, at which point the call will fail. The delay is also jittered between the current and next delay to spread out service load. The default for the HTTP timeout window is 20 seconds and can be changed using HCSettingsSetTimeoutWindow()<br /><br /> If the service returns an HTTP error with a "Retry-After" header, then all future calls to that API will immediately fail with the original error without contacting the service until the "Retry-After" time has been reached.<br /><br /> Idempotent service calls are retried when a network error occurs or the server responds <br /> with one of these HTTP status codes:<br /> 408 (Request Timeout)<br /> 429 (Too Many Requests)<br /> 500 (Internal Server Error)<br /> 502 (Bad Gateway)<br /> 503 (Service Unavailable)<br /> 504 (Gateway Timeout)<br />

## Requirements

**Header:** httpProvider.h

**Library:** libHttpClient.GDK.lib

## See also

[httpProvider](/reference/live/httpclient/httpprovider/httpprovider_members)


## Related topics

- [HCHttpCallRequestSetRetryDelay](/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetretrydelay.md)
- [XblContextSettingsGetHttpRetryDelay](/reference/live/xsapi-c/xbox_live_context_settings_c/functions/xblcontextsettingsgethttpretrydelay.md)
- [HCHttpCallRequestGetRetryAllowed](/reference/live/httpclient/httpprovider/functions/hchttpcallrequestgetretryallowed.md)
- [HCHttpCallRequestGetRetryCacheId](/reference/live/httpclient/httpprovider/functions/hchttpcallrequestgetretrycacheid.md)
- [HCHttpCallRequestSetRetryAllowed](/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetretryallowed.md)