Skip to content

Commit 7a12868

Browse files
oschwaldclaude
andcommitted
Add release notes for legacy web service HTTP status codes
Announce that the GeoIP Legacy, minFraud Legacy, and Proxy Detection web services now return meaningful HTTP status codes (400/401/402/403) for error conditions, while IP-not-found and the response body are unchanged. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 581eb8a commit 7a12868

2 files changed

Lines changed: 42 additions & 0 deletions

File tree

content/geoip/release-notes/2026.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,26 @@ outputs: ['html', 'markdown']
99
[Sign up to be notified](https://comms.maxmind.com/geoip-rss-release-notes)
1010
whenever a new GeoIP release note is posted. {{</ alert >}}
1111

12+
{{< release-note date="2026-06-30" title="GeoIP Legacy web service now returns HTTP status codes for errors" >}}
13+
14+
The GeoIP Legacy web service now returns meaningful HTTP status codes for error
15+
conditions, so you can detect them at the HTTP layer (for example, with an edge
16+
or CDN rule) without parsing the response body:
17+
18+
- `400 Bad Request` for a malformed request
19+
- `401 Unauthorized` for a missing or invalid license key
20+
- `402 Payment Required` when your account is out of queries
21+
- `403 Forbidden` when your account does not have permission to use the service
22+
- `5xx` for a server error
23+
24+
The response body and its error-code strings are unchanged. The `IP_NOT_FOUND`
25+
case continues to return a `200 OK` status to avoid breaking existing
26+
integrations.
27+
28+
[See the GeoIP Legacy documentation for details.](/geoip/docs/web-services/legacy/#http-status-codes)
29+
30+
{{</ release-note >}}
31+
1232
{{< release-note date="2026-06-11" title="City field blanked in selected cities/provinces and countries" >}}
1333

1434
Effective Monday, June 15, 2026, we will be blanking out the city field more

content/minfraud/release-notes/2026.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,28 @@ outputs: ['html', 'markdown']
99
[Sign up to be notified](https://comms.maxmind.com/minfraud-rss-release-notes)
1010
whenever a new minFraud release note is posted. {{</ alert >}}
1111

12+
{{< release-note date="2026-06-30" title="minFraud Legacy and Proxy Detection web services now return HTTP status codes for errors" >}}
13+
14+
The minFraud Legacy and Proxy Detection web services now return meaningful HTTP
15+
status codes for error conditions, so you can detect them at the HTTP layer (for
16+
example, with an edge or CDN rule) without parsing the response body:
17+
18+
- `400 Bad Request` for a malformed request
19+
- `401 Unauthorized` for a missing or invalid license key
20+
- `402 Payment Required` when your account is out of queries
21+
- `403 Forbidden` when your account does not have permission to use the service
22+
- `5xx` for a server error
23+
24+
The response body and its error-code strings are unchanged. Warning conditions,
25+
including `IP_NOT_FOUND`, continue to return a `200 OK` status to avoid breaking
26+
existing integrations.
27+
28+
[See the minFraud Legacy](/minfraud/minfraud-legacy/#http-status-codes) and
29+
[Proxy Detection](/minfraud/proxy-detection/#http-status-codes) documentation
30+
for details.
31+
32+
{{</ release-note >}}
33+
1234
{{< release-note date="2026-05-13" title="Improved readability of the risk reasons module within Transactions Details screen">}}
1335

1436
Based on user feedback, we have updated the risk reasons module within the

0 commit comments

Comments
 (0)