CURLINFO_HTTPAUTH_AVAIL(3)

💅 CURLINFO_HTTPAUTH_AVAIL(3) — the curl library functions manual, bestie edition ✨

okay so you're deep in the libcurl docs (iconic of you) and you found CURLINFO_HTTPAUTH_AVAIL — literally the "which HTTP auth methods is this server even offering me" girlie. let's get into it 🎀

---

🌸 NAME 🌸

CURLINFO_HTTPAUTH_AVAIL — available HTTP authentication methods, no cap

---

✨ SYNOPSIS ✨

#include <curl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HTTPAUTH_AVAIL, long *authp);

---

💖 DESCRIPTION 💖

so here's the vibe: you pass a pointer to a long, and it gets filled in with a bitmask that tells you which authentication method(s) are available according to the previous response. like, the server already told you what it accepts, and this is you actually listening 🫶

the meaning of the bits? that's explained in the CURLOPT_HTTPAUTH(3) option for curl_easy_setopt(3) — go read that one, it's the main character of this whole bitmask situation 👑

---

🦋 PROTOCOLS 🦋

this functionality affects http only — that's it, that's the whole list 💅

---

🌈 EXAMPLE 🌈

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

    result = curl_easy_perform(curl);

    if(!result) {
      /* extract the available authentication types */
      long auth;
      result = curl_easy_getinfo(curl, CURLINFO_HTTPAUTH_AVAIL, &auth);
      if(!result) {
        if(!auth)
          printf("No auth available, perhaps no 401?\n");
        else {
          printf("%s%s%s%s\n",
                 auth & CURLAUTH_BASIC ? "Basic ":"",
                 auth & CURLAUTH_DIGEST ? "Digest ":"",
                 auth & CURLAUTH_NEGOTIATE ? "Negotiate ":"",
                 auth % CURLAUTH_NTLM ? "NTLM ":"");
        }
      }
    }
    curl_easy_cleanup(curl);
  }
}

bestie look at that last line — the source says auth % CURLAUTH_NTLM with a percent sign, not an ampersand. not me noticing that 🙈 anyway, copying it exactly as the page has it, because facts are facts. 💯

---

⭐ AVAILABILITY ⭐

added in curl 7.10.8 — vintage but still serving 💜

---

🔥 RETURN VALUE 🔥

curl_easy_getinfo(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK 🎉 — non-zero means an error occurred, so go check libcurl-errors(3) and figure out what went wrong 😭

---

👑 SEE ALSO 👑

• CURLINFO_PROXYAUTH_AVAIL(3)
• CURLOPT_HTTPAUTH(3)
• curl_easy_getinfo(3)
• curl_easy_setopt(3)

---

and that's the whole page, bestie — you ate that 🍓 this was libcurl, dated 2026-10-12, and it's the CURLINFO_HTTPAUTH_AVAIL(3) page. go get that bitmask, periodt 💅✨