An IP address lookup API with ASP.NET Core minimal APIs

Minimal APIs let you declare HTTP endpoints straight in Program.cs with MapGet, MapPost and friends, without controllers. That suits a small service like this one, which has three endpoints:
GET /ipreturns the public IP address of the machine running the API (via jsonip.com).GET /ip/{address}returns registry, country and ASN details for an IP address.GET /ip/inforeturns the same details for the caller’s IP address.
The code was first written for .NET 7 with Swashbuckle. It’s updated here for .NET 10, which has OpenAPI document generation built in.
Create the project from the Web API template, which already references Microsoft.AspNetCore.OpenApi:
dotnet new webapi -n IpApicd IpApiProgram.cs
Section titled “Program.cs”using System.Net;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddOpenApi(); // OpenAPI document generationbuilder.Services.AddHttpClient(); // registers IHttpClientFactory
var app = builder.Build();
app.MapOpenApi(); // serves /openapi/v1.json
app.MapGet("/", () => "Hello World!").WithName("HelloWorld");
var ip = app.MapGroup("/ip");
// Public IP of the machine running this APIip.MapGet("/", async (IHttpClientFactory factory) =>{ var client = factory.CreateClient(); var response = await client.GetFromJsonAsync<JsonIpResponse>("https://jsonip.com"); return response is null ? Results.Problem("jsonip.com returned no data") : Results.Ok(response.Ip);}).WithName("GetIpAddress");
// Details for the caller's IP. Literal segments win over parameters,// so /ip/info does not get captured by /ip/{address}.ip.MapGet("/info", async (HttpContext context, IHttpClientFactory factory) =>{ IPAddress? remote = context.Connection.RemoteIpAddress; if (remote is null) { return Results.BadRequest("Could not determine the caller's IP address"); } if (remote.IsIPv4MappedToIPv6) { remote = remote.MapToIPv4(); // "::ffff:1.2.3.4" -> "1.2.3.4" } return await LookupAsync(factory.CreateClient(), remote.ToString());}).WithName("GetCallerIpInfo");
// Details for any IP addressip.MapGet("/{address}", async (string address, IHttpClientFactory factory) =>{ if (!IPAddress.TryParse(address, out _)) { return Results.BadRequest("Not a valid IP address"); } return await LookupAsync(factory.CreateClient(), address);}).WithName("GetIp");
app.Run();
static async Task<IResult> LookupAsync(HttpClient client, string address){ var info = await client.GetFromJsonAsync<IpInfo>($"https://iplist.cc/api/{address}"); return info is null ? Results.Problem("Lookup returned no data") : Results.Ok(info);}
record JsonIpResponse(string Ip);
record IpInfo( string Ip, string Registry, string CountryCode, string CountryName, Asn? Asn, bool Spam, bool Tor, string? City, string? Detail, string[]? Website);
record Asn(string Code, string Name, string Route, string Start, string End, string Count);A few things worth pointing out:
GetFromJsonAsyncdeserializes with the web defaults, which match property names case-insensitively, so the lowercase JSON fields (countrycode,countryname) map onto PascalCase record properties. It also throwsHttpRequestExceptionon a non-success status code, which surfaces as a 500 response.- The original version created a
new HttpClient()per request and wrapped each call incatch (Exception e) { throw e; }. The first can exhaust sockets under load; the second throws away the stack trace.IHttpClientFactoryand letting exceptions propagate fix both. /ipreturns the server’s public address, because the outbound request to jsonip.com comes from the server. Use/ip/infofor the caller’s address.
The caller’s IP behind a proxy
Section titled “The caller’s IP behind a proxy”Connection.RemoteIpAddress is the address of whatever opened the TCP connection. Behind a reverse proxy or load balancer, that’s the proxy. The earlier version only read X-Forwarded-For when RemoteIpAddress was null, which never happens behind a proxy.
The fix is the forwarded headers middleware, which rewrites RemoteIpAddress from X-Forwarded-For. Only trust the header from proxies you list in KnownProxies or KnownIPNetworks (KnownNetworks before .NET 10), because otherwise any client can set it to whatever it likes. See Configure ASP.NET Core to work with proxy servers and load balancers.
OpenAPI and WithOpenApi
Section titled “OpenAPI and WithOpenApi”The 2023 version called .WithOpenApi() on each endpoint. That’s no longer needed: AddOpenApi() includes every endpoint in the document, and WithOpenApi is marked obsolete in .NET 10 (diagnostic ASPDEPR002). Use WithSummary, WithDescription and WithTags for per-endpoint metadata.
.NET 9 and later templates don’t ship Swagger UI. To browse the API, point Swagger UI, Scalar or another OpenAPI viewer at /openapi/v1.json.
Further reading
Section titled “Further reading”© 2026 David Li · Home · Blog · RSS ·Classic site · Built with Astro, Starlight and three.js · Logos:Font Awesome Free (CC BY 4.0)