Endpoint
POST https://requiems.xyz/v1/systems/location/resolve
Resolve Location
Resolve an address or coordinates into a full location profile — city, country, timezone, UTC offset, current time, working days this month, and next holiday.
Parameters
| Name |
Type |
Required |
Location |
Description |
address |
string |
no |
body |
Human-readable address string to geocode. Either address or coordinates is required. |
coordinates |
object |
no |
body |
Coordinates object for reverse geocoding. Either address or coordinates is required. Shape: {lat: float, lng: float} |
country_code |
string |
no |
body |
ISO 3166-1 alpha-2 country code hint. Overrides the geocoder-inferred country code when provided. |
Request Example
{
"address": "Alexanderplatz 1, Berlin",
"country_code": "DE"
}
Response Example
{
"data": {
"address": "Alexanderplatz 1, 10178 Berlin, Germany",
"city": "Berlin",
"country": "Germany",
"country_code": "DE",
"coordinates": {
"lat": 52.5219,
"lng": 13.4132
},
"timezone": "Europe/Berlin",
"utc_offset": "+02:00",
"current_time": "2026-06-15T14:32:00+02:00",
"is_holiday_today": false,
"working_days_this_month": 21,
"next_holiday": {
"date": "2026-10-03",
"name": "German Unity Day",
"type": "national"
},
"flags": []
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
address |
string |
Normalized full address returned by the geocoder |
city |
string |
City name |
country |
string |
Full country name |
country_code |
string |
ISO 3166-1 alpha-2 country code |
coordinates |
object |
Resolved lat/lng coordinates |
timezone |
string |
IANA timezone identifier (e.g. Europe/Berlin). Null when timezone resolution fails. |
utc_offset |
string |
UTC offset string (e.g. +02:00). Null when timezone resolution fails. |
current_time |
string |
Current local time in RFC3339 format. Null when timezone resolution fails. |
is_holiday_today |
boolean |
True when today is a public holiday in the resolved country |
working_days_this_month |
integer |
Number of working days (excluding weekends and public holidays) in the current calendar month |
next_holiday |
object |
Next public holiday within 90 days. Shape: {date: YYYY-MM-DD, name: string, type: national} |
flags |
array |
Non-fatal warnings. Possible values: timezone_unavailable, calendar_unavailable |
Errors
undefined 422 — Neither address nor coordinates was providedundefined 422 — Geocoding service was unavailableundefined 401 — Missing or invalid API key
1---
2name: global-data-post-resolve
3api: Global Data System
4method: POST
5path: /v1/systems/location/resolve
6base_url: https://requiems.xyz
7description: Resolve an address or coordinates into a full location profile — city, country, timezone, UTC offset, current time, working days this month, and next holiday.
8---
9
10## Endpoint
11
12**POST https://requiems.xyz/v1/systems/location/resolve**
13
14## Resolve Location
15
16Resolve an address or coordinates into a full location profile — city, country, timezone, UTC offset, current time, working days this month, and next holiday.
17
18## Parameters
19
20| Name | Type | Required | Location | Description |
21| ---- | ---- | -------- | -------- | ----------- |
22| `address` | string | no | body | Human-readable address string to geocode. Either address or coordinates is required. |
23| `coordinates` | object | no | body | Coordinates object for reverse geocoding. Either address or coordinates is required. Shape: {lat: float, lng: float} |
24| `country_code` | string | no | body | ISO 3166-1 alpha-2 country code hint. Overrides the geocoder-inferred country code when provided. |
25
26## Request Example
27
28```json
29{
30 "address": "Alexanderplatz 1, Berlin",
31 "country_code": "DE"
32}
33```
34
35## Response Example
36
37```json
38{
39 "data": {
40 "address": "Alexanderplatz 1, 10178 Berlin, Germany",
41 "city": "Berlin",
42 "country": "Germany",
43 "country_code": "DE",
44 "coordinates": {
45 "lat": 52.5219,
46 "lng": 13.4132
47 },
48 "timezone": "Europe/Berlin",
49 "utc_offset": "+02:00",
50 "current_time": "2026-06-15T14:32:00+02:00",
51 "is_holiday_today": false,
52 "working_days_this_month": 21,
53 "next_holiday": {
54 "date": "2026-10-03",
55 "name": "German Unity Day",
56 "type": "national"
57 },
58 "flags": []
59 },
60 "metadata": {
61 "timestamp": "2026-01-01T00:00:00Z"
62 }
63}
64```
65
66## Response Fields
67
68| Field | Type | Description |
69| ----- | ---- | ----------- |
70| `address` | string | Normalized full address returned by the geocoder |
71| `city` | string | City name |
72| `country` | string | Full country name |
73| `country_code` | string | ISO 3166-1 alpha-2 country code |
74| `coordinates` | object | Resolved lat/lng coordinates |
75| `timezone` | string | IANA timezone identifier (e.g. Europe/Berlin). Null when timezone resolution fails. |
76| `utc_offset` | string | UTC offset string (e.g. +02:00). Null when timezone resolution fails. |
77| `current_time` | string | Current local time in RFC3339 format. Null when timezone resolution fails. |
78| `is_holiday_today` | boolean | True when today is a public holiday in the resolved country |
79| `working_days_this_month` | integer | Number of working days (excluding weekends and public holidays) in the current calendar month |
80| `next_holiday` | object | Next public holiday within 90 days. Shape: {date: YYYY-MM-DD, name: string, type: national} |
81| `flags` | array<string> | Non-fatal warnings. Possible values: timezone_unavailable, calendar_unavailable |
82
83## Errors
84
85- `undefined` **422** — Neither address nor coordinates was provided
86- `undefined` **422** — Geocoding service was unavailable
87- `undefined` **401** — Missing or invalid API key
gabrielmoreira