---
name: "CURLINFO_PRIMARY_IP"
section: "3"
platform: "linux"
package: "curl"
version: "8.23.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/CURLINFO_PRIMARY_IP"
---

# CURLINFO\_PRIMARY\_IP(3)

IP address of last connection

## NAME

CURLINFO\_PRIMARY\_IP - IP address of last connection

## SYNOPSIS

```
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIMARY_IP, char **ip);
```

## DESCRIPTION

Pass a pointer to a char pointer to receive the pointer to a null-terminated string holding the IP address of the most recent connection done with this **curl** handle. This string may be IPv6 when that is enabled. Note that you get a pointer to a memory area that is reused at next request so you need to copy the string if you want to keep the information.

The **ip** pointer is NULL or points to private memory. You **must not** free it. The memory gets freed automatically when you call *[curl\_easy\_cleanup(3)](/curl_easy_cleanup/3.md)* on the corresponding curl handle.

## PROTOCOLS

This functionality affects all supported protocols

## EXAMPLE

```
int main(void)
{
  char *ip;
  CURLcode result;
  CURL *curl = curl_easy_init();
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
  /* Perform the transfer */
  result = curl_easy_perform(curl);
  /* Check for errors */
  if((result == CURLE_OK) &&
     !curl_easy_getinfo(curl, CURLINFO_PRIMARY_IP, &ip) && ip) {
    printf("IP: %s\n", ip);
  }
  /* always cleanup */
  curl_easy_cleanup(curl);
}
```

## AVAILABILITY

Added in curl 7.19.0

## RETURN VALUE

*[curl\_easy\_getinfo(3)](/curl_easy_getinfo/3.md)* returns a CURLcode indicating success or error.

CURLE\_OK (0) means everything was OK, non-zero means an error occurred, see *[libcurl-errors(3)](/libcurl-errors/3.md)*.

## SEE ALSO

[**CURLINFO\_LOCAL\_IP**(3)](/CURLINFO_LOCAL_IP/3.md), [**CURLINFO\_LOCAL\_PORT**(3)](/CURLINFO_LOCAL_PORT/3.md), [**CURLINFO\_PRIMARY\_PORT**(3)](/CURLINFO_PRIMARY_PORT/3.md), [**curl\_easy\_getinfo**(3)](/curl_easy_getinfo/3.md), [**curl\_easy\_setopt**(3)](/curl_easy_setopt/3.md)