path: root/docs/libcurl/curl_easy_getinfo.md

---
c: Copyright (C) Daniel Stenberg, <daniel.se>, et al.
SPDX-License-Identifier: curl
Title: curl_easy_getinfo
Section: 3
Source: libcurl
See-also:
  - curl_easy_setopt (3)
---

# NAME

curl_easy_getinfo - extract information from a curl handle

# SYNOPSIS

~~~c
#include <curl/curl.h>

CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );
~~~

# DESCRIPTION

Get the *info* kept in the *curl* handle. The third argument **MUST** be
pointing to the specific type of the used option which is documented in each
man page of the *info* option. The data is stored accordingly and can be
relied upon only if this function returns CURLE_OK. Use this function after a
performed transfer if you want to get transfer related data.

You should not free the memory returned by this function unless it is
explicitly mentioned below.

# AVAILABLE INFORMATION

The following information can be extracted:

## CURLINFO_EFFECTIVE_METHOD

Last used HTTP method. See CURLINFO_EFFECTIVE_METHOD(3)

## CURLINFO_EFFECTIVE_URL

Last used URL. See CURLINFO_EFFECTIVE_URL(3)

## CURLINFO_RESPONSE_CODE

Last received response code. See CURLINFO_RESPONSE_CODE(3)

## CURLINFO_REFERER

Referrer header. See CURLINFO_REFERER(3)

## CURLINFO_HTTP_CONNECTCODE

Last proxy CONNECT response code. See CURLINFO_HTTP_CONNECTCODE(3)

## CURLINFO_HTTP_VERSION

The http version used in the connection. See CURLINFO_HTTP_VERSION(3)

## CURLINFO_FILETIME

Remote time of the retrieved document. See CURLINFO_FILETIME(3)

## CURLINFO_FILETIME_T

Remote time of the retrieved document. See CURLINFO_FILETIME_T(3)

## CURLINFO_TOTAL_TIME

Total time of previous transfer. See CURLINFO_TOTAL_TIME(3)

## CURLINFO_TOTAL_TIME_T

Total time of previous transfer. See CURLINFO_TOTAL_TIME_T(3)

## CURLINFO_NAMELOOKUP_TIME

Time from start until name resolving completed. See
CURLINFO_NAMELOOKUP_TIME(3)

## CURLINFO_NAMELOOKUP_TIME_T

Time from start until name resolving completed. See
CURLINFO_NAMELOOKUP_TIME_T(3)

## CURLINFO_CONNECT_TIME

Time from start until remote host or proxy completed.
See CURLINFO_CONNECT_TIME(3)

## CURLINFO_CONNECT_TIME_T

Time from start until remote host or proxy completed.
See CURLINFO_CONNECT_TIME_T(3)

## CURLINFO_APPCONNECT_TIME

Time from start until SSL/SSH handshake completed.
See CURLINFO_APPCONNECT_TIME(3)

## CURLINFO_APPCONNECT_TIME_T

Time from start until SSL/SSH handshake completed.
See CURLINFO_APPCONNECT_TIME_T(3)

## CURLINFO_PRETRANSFER_TIME

Time from start until just before the transfer begins.
See CURLINFO_PRETRANSFER_TIME(3)

## CURLINFO_PRETRANSFER_TIME_T

Time from start until just before the transfer begins.
See CURLINFO_PRETRANSFER_TIME_T(3)

## CURLINFO_QUEUE_TIME_T

Time during which this transfer was held in a waiting queue.
See CURLINFO_QUEUE_TIME_T(3)

## CURLINFO_STARTTRANSFER_TIME

Time from start until just when the first byte is received.
See CURLINFO_STARTTRANSFER_TIME(3)

## CURLINFO_STARTTRANSFER_TIME_T

Time from start until just when the first byte is received.
See CURLINFO_STARTTRANSFER_TIME_T(3)

## CURLINFO_REDIRECT_TIME

Time taken for all redirect steps before the final transfer.
See CURLINFO_REDIRECT_TIME(3)

## CURLINFO_REDIRECT_TIME_T

Time taken for all redirect steps before the final transfer.
See CURLINFO_REDIRECT_TIME_T(3)

## CURLINFO_REDIRECT_COUNT

Total number of redirects that were followed.
See CURLINFO_REDIRECT_COUNT(3)

## CURLINFO_REDIRECT_URL

URL a redirect would take you to, had you enabled redirects.
See CURLINFO_REDIRECT_URL(3)

## CURLINFO_SIZE_UPLOAD

(Deprecated) Number of bytes uploaded.
See CURLINFO_SIZE_UPLOAD(3)

## CURLINFO_SIZE_UPLOAD_T

Number of bytes uploaded.
See CURLINFO_SIZE_UPLOAD_T(3)

## CURLINFO_SIZE_DOWNLOAD

(Deprecated) Number of bytes downloaded.
See CURLINFO_SIZE_DOWNLOAD(3)

## CURLINFO_SIZE_DOWNLOAD_T

Number of bytes downloaded.
See CURLINFO_SIZE_DOWNLOAD_T(3)

## CURLINFO_SPEED_DOWNLOAD

(Deprecated) Average download speed.
See CURLINFO_SPEED_DOWNLOAD(3)

## CURLINFO_SPEED_DOWNLOAD_T

Average download speed.
See CURLINFO_SPEED_DOWNLOAD_T(3)

## CURLINFO_SPEED_UPLOAD

(Deprecated) Average upload speed.
See CURLINFO_SPEED_UPLOAD(3)

## CURLINFO_SPEED_UPLOAD_T

Average upload speed.
See CURLINFO_SPEED_UPLOAD_T(3)

## CURLINFO_HEADER_SIZE

Number of bytes of all headers received.
See CURLINFO_HEADER_SIZE(3)

## CURLINFO_REQUEST_SIZE

Number of bytes sent in the issued HTTP requests.
See CURLINFO_REQUEST_SIZE(3)

## CURLINFO_SSL_VERIFYRESULT

Certificate verification result.
See CURLINFO_SSL_VERIFYRESULT(3)

## CURLINFO_PROXY_ERROR

Detailed proxy error.
See CURLINFO_PROXY_ERROR(3)

## CURLINFO_PROXY_SSL_VERIFYRESULT

Proxy certificate verification result.
See CURLINFO_PROXY_SSL_VERIFYRESULT(3)

## CURLINFO_SSL_ENGINES

A list of OpenSSL crypto engines.
See CURLINFO_SSL_ENGINES(3)

## CURLINFO_CONTENT_LENGTH_DOWNLOAD

(Deprecated) Content length from the Content-Length header.
See CURLINFO_CONTENT_LENGTH_DOWNLOAD(3)

## CURLINFO_CONTENT_LENGTH_DOWNLOAD_T

Content length from the Content-Length header.
See CURLINFO_CONTENT_LENGTH_DOWNLOAD_T(3)

## CURLINFO_CONTENT_LENGTH_UPLOAD

(Deprecated) Upload size. See CURLINFO_CONTENT_LENGTH_UPLOAD(3)

## CURLINFO_CONTENT_LENGTH_UPLOAD_T

Upload size. See CURLINFO_CONTENT_LENGTH_UPLOAD_T(3)

## CURLINFO_CONTENT_TYPE

Content type from the Content-Type header.
See CURLINFO_CONTENT_TYPE(3)

## CURLINFO_RETRY_AFTER

The value from the Retry-After header.
See CURLINFO_RETRY_AFTER(3)

## CURLINFO_PRIVATE

User's private data pointer.
See CURLINFO_PRIVATE(3)

## CURLINFO_HTTPAUTH_AVAIL

Available HTTP authentication methods.
See CURLINFO_HTTPAUTH_AVAIL(3)

## CURLINFO_PROXYAUTH_AVAIL

Available HTTP proxy authentication methods.
See CURLINFO_PROXYAUTH_AVAIL(3)

## CURLINFO_OS_ERRNO

The errno from the last failure to connect.
See CURLINFO_OS_ERRNO(3)

## CURLINFO_NUM_CONNECTS

Number of new successful connections used for previous transfer.
See CURLINFO_NUM_CONNECTS(3)

## CURLINFO_PRIMARY_IP

Destination IP address of the last connection.
See CURLINFO_PRIMARY_IP(3)

## CURLINFO_PRIMARY_PORT

Destination port of the last connection.
See CURLINFO_PRIMARY_PORT(3)

## CURLINFO_LOCAL_IP

Source IP address of the last connection.
See CURLINFO_LOCAL_IP(3)

## CURLINFO_LOCAL_PORT

Source port number of the last connection.
See CURLINFO_LOCAL_PORT(3)

## CURLINFO_COOKIELIST

List of all known cookies.
See CURLINFO_COOKIELIST(3)

## CURLINFO_LASTSOCKET

(Deprecated) Last socket used.
See CURLINFO_LASTSOCKET(3)

## CURLINFO_ACTIVESOCKET

The session's active socket.
See CURLINFO_ACTIVESOCKET(3)

## CURLINFO_FTP_ENTRY_PATH

The entry path after logging in to an FTP server.
See CURLINFO_FTP_ENTRY_PATH(3)

## CURLINFO_CAPATH

Get the default value for CURLOPT_CAPATH(3).
See CURLINFO_CAPATH(3)

## CURLINFO_CAINFO

Get the default value for CURLOPT_CAINFO(3).
See CURLINFO_CAINFO(3)

## CURLINFO_CERTINFO

Certificate chain.
See CURLINFO_CERTINFO(3)

## CURLINFO_TLS_SSL_PTR

TLS session info that can be used for further processing.
See CURLINFO_TLS_SSL_PTR(3)

## CURLINFO_TLS_SESSION

TLS session info that can be used for further processing. See
CURLINFO_TLS_SESSION(3). Deprecated option, use
CURLINFO_TLS_SSL_PTR(3) instead!

## CURLINFO_CONDITION_UNMET

Whether or not a time conditional was met or 304 HTTP response.
See CURLINFO_CONDITION_UNMET(3)

## CURLINFO_RTSP_SESSION_ID

RTSP session ID.
See CURLINFO_RTSP_SESSION_ID(3)

## CURLINFO_RTSP_CLIENT_CSEQ

The RTSP client CSeq that is expected next.
See CURLINFO_RTSP_CLIENT_CSEQ(3)

## CURLINFO_RTSP_SERVER_CSEQ

The RTSP server CSeq that is expected next.
See CURLINFO_RTSP_SERVER_CSEQ(3)

## CURLINFO_RTSP_CSEQ_RECV

RTSP CSeq last received.
See CURLINFO_RTSP_CSEQ_RECV(3)

## CURLINFO_PROTOCOL

(Deprecated) The protocol used for the connection. (Added in 7.52.0)
See CURLINFO_PROTOCOL(3)

## CURLINFO_SCHEME

The scheme used for the connection. (Added in 7.52.0)
See CURLINFO_SCHEME(3)

## CURLINFO_CONN_ID

The ID of the last connection used by the transfer. (Added in 8.2.0)
See CURLINFO_CONN_ID(3)

## CURLINFO_XFER_ID

The ID of the transfer. (Added in 8.2.0)
See CURLINFO_XFER_ID(3)

# TIMES

An overview of the time values available from curl_easy_getinfo(3)

~~~
curl_easy_perform()
    |
    |--QUEUE_TIME
    |--|--NAMELOOKUP
    |--|--|--CONNECT
    |--|--|--|--APPCONNECT
    |--|--|--|--|--PRETRANSFER
    |--|--|--|--|--|--STARTTRANSFER
    |--|--|--|--|--|--|--TOTAL
    |--|--|--|--|--|--|--REDIRECT
~~~

## QUEUE_TIME

CURLINFO_QUEUE_TIME_T(3). The time during which the transfer was held in a
waiting queue before it could start for real. (Added in 8.6.0)

## NAMELOOKUP

CURLINFO_NAMELOOKUP_TIME(3) and CURLINFO_NAMELOOKUP_TIME_T(3). The time it
took from the start until the name resolving was completed.

## CONNECT

CURLINFO_CONNECT_TIME(3) and CURLINFO_CONNECT_TIME_T(3). The time it took from
the start until the connect to the remote host (or proxy) was completed.

## APPCONNECT

CURLINFO_APPCONNECT_TIME(3) and CURLINFO_APPCONNECT_TIME_T(3). The time it
took from the start until the SSL connect/handshake with the remote host was
completed. (Added in 7.19.0) The latter is the integer version (measuring
microseconds). (Added in 7.60.0)

## PRETRANSFER

CURLINFO_PRETRANSFER_TIME(3) and CURLINFO_PRETRANSFER_TIME_T(3). The time it
took from the start until the file transfer is just about to begin. This
includes all pre-transfer commands and negotiations that are specific to the
particular protocol(s) involved.

## STARTTRANSFER

CURLINFO_STARTTRANSFER_TIME(3) and CURLINFO_STARTTRANSFER_TIME_T(3). The time
it took from the start until the first byte is received by libcurl.

## TOTAL

CURLINFO_TOTAL_TIME(3) and CURLINFO_TOTAL_TIME_T(3). Total time
of the previous request.

## REDIRECT

CURLINFO_REDIRECT_TIME(3) and CURLINFO_REDIRECT_TIME_T(3). The time it took
for all redirection steps include name lookup, connect, pretransfer and
transfer before final transaction was started. So, this is zero if no
redirection took place.

# EXAMPLE

~~~c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode res;
    curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");
    res = curl_easy_perform(curl);

    if(CURLE_OK == res) {
      char *ct;
      /* ask for the content-type */
      res = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);

      if((CURLE_OK == res) && ct)
        printf("We received Content-Type: %s\n", ct);
    }

    /* always cleanup */
    curl_easy_cleanup(curl);
  }
}
~~~

# AVAILABILITY

Added in 7.4.1

# RETURN VALUE

If the operation was successful, CURLE_OK is returned. Otherwise an
appropriate error code is returned.