@roxyapi/sdk 1.2.23 → 1.2.25

package/AGENTS.md

@@ -41,22 +41,32 @@ Type `roxy.` to see all available namespaces. Type `roxy.{domain}.` to see every
 <!-- BEGIN:DOMAINS -->
 | Namespace | Endpoints | What it covers |
 |-----------|-----------|----------------|
-| `roxy.astrology` | 22 | Western astrology: natal charts, horoscopes, synastry, moon phases, transits, compatibility |
-| `roxy.vedicAstrology` | 42 | Vedic/Jyotish: birth charts, dashas, nakshatras, panchang, KP system, doshas, yogas |
-| `roxy.numerology` | 16 | Life path, expression, soul urge, personal year, karmic analysis, compatibility |
-| `roxy.tarot` | 10 | Rider-Waite-Smith deck: spreads, daily pulls, yes/no, Celtic Cross, custom layouts |
-| `roxy.biorhythm` | 6 | 10-cycle biorhythm readings, forecasts, critical days, compatibility, daily check-ins (wellness, dating, productivity) |
-| `roxy.iching` | 9 | I Ching: hexagrams, trigrams, coin casting, daily readings |
-| `roxy.crystals` | 12 | Crystal healing properties, zodiac/chakra pairings, birthstones, search |
-| `roxy.dreams` | 5 | Dream symbol dictionary and interpretations |
-| `roxy.angelNumbers` | 4 | Angel number meanings, pattern analysis, daily guidance |
-| `roxy.location` | 3 | City geocoding for birth chart coordinates |
-| `roxy.usage` | 1 | API usage stats and subscription info |
-| `roxy.languages` | 1 | Supported response languages for the lang query parameter (code, English name, native name) |
+| `roxy.astrology` | 22 | Production-ready Western astrology API + remote MCP for AI agents and developers |
+| `roxy.vedicAstrology` | 42 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
+| `roxy.numerology` | 16 | Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers |
+| `roxy.tarot` | 10 | Production-ready tarot card reading API + hosted MCP for AI agents and developers |
+| `roxy.biorhythm` | 6 | The most complete biorhythm API + remote MCP for AI agents and developers |
+| `roxy.iching` | 9 | I-Ching oracle API + hosted MCP for AI agents and developers |
+| `roxy.crystals` | 12 | Production-ready crystal healing API + hosted MCP for AI agents and developers |
+| `roxy.dreams` | 5 | Dream interpretation API + hosted MCP for AI agents and developers |
+| `roxy.angelNumbers` | 4 | Production-ready angel numbers API + hosted MCP for AI agents and developers |
+| `roxy.location` | 3 | City search and geocoding API + hosted MCP for AI agents and astrology apps |
+| `roxy.usage` | 1 | Monitor your API usage, check rate limits, and track request consumption |
+| `roxy.languages` | 1 | List the response languages accepted by the `lang` query parameter on every i18n-aware endpoint |
 <!-- END:DOMAINS -->
 
 **Total:** 130 endpoints across 10 product domains plus usage and languages. Counts auto-sync from `specs/openapi.json` at release time.
 
+## Quality guidelines for agents
+
+Five rules to follow when writing any call with this SDK. Get these right and the generated types do the rest.
+
+- **One options object, hey-api wrapped.** Every method takes a single object with `path`, `query`, and `body` keys. Path params go in `path`, query params in `query`, request body in `body`. Never flat named args. Right: `roxy.astrology.getDailyHoroscope({ path: { sign: 'aries' } })`. Wrong: `roxy.astrology.getDailyHoroscope({ sign: 'aries' })`.
+- **Always `await`. Always destructure `{ data, error, response }`.** All methods are async. `data` is the typed success response (undefined on error). `error` is the typed API error (`{ error: string, code: string }`, undefined on success). `response` is the raw `fetch` Response. Switch on `error.code`, not on `error.error`.
+- **Method names match the OpenAPI `operationId` verbatim.** When in doubt, autocomplete `roxy.{domain}.` in your editor or `grep 'public ' node_modules/@roxyapi/sdk/dist/factory.d.ts`. Never invent a method from the URL path or a guess.
+- **Response field names come from the spec's response schema.** Field access is typed dot syntax (`data.cities[0].timezone`). TypeScript will catch any invented field at compile time via the generated types - if `tsc` complains, the field does not exist.
+- **Do not hand-roll requests.** No raw `fetch`, no axios. The SDK injects auth, base URL, retries, and typed responses. Use `createRoxy(key)` for the common case, or `new Roxy({ client })` with `createClient` from `@roxyapi/sdk/client` when you need a custom fetch or interceptors.
+
 ## Critical patterns
 
 ### Two-step pattern for coordinate-dependent endpoints
@@ -192,13 +202,14 @@ These are the fields AI agents most often get wrong. Copy the format column exac
 | `latitude` | Decimal degrees (number) | `28.6139` (Delhi), `-33.8688` (Sydney), `40.7128` (NYC) | `"28°36'N"`, `"28 36 50"`, strings |
 | `longitude` | Decimal degrees (number) | `77.209` (Delhi), `-74.006` (NYC), `139.6917` (Tokyo) | Same as latitude - no DMS strings |
 | `sign` (horoscope path) | Lowercase zodiac name | `aries`, `taurus`, `gemini`, ... `pisces` | `"Aries"`, `"♈"`, `"1"`, `"ARIES"` (case-insensitive but prefer lowercase) |
+| `chakra` (crystals path) | Title-case English name from the fixed enum | `"Root"`, `"Sacral"`, `"Solar Plexus"`, `"Heart"`, `"Throat"`, `"Third Eye"`, `"Crown"` | `"heart"`, `"third-eye"`, `"solar plexus"` - route is case-insensitive at runtime, but the generated TS enum is title-case; lowercase fails `tsc --strict`. |
 | `fullName` (numerology) | Birth-certificate name | `"John William Smith"`, `"Priya Rajesh Sharma"` | Nickname, married name, partial name - affects all letter-based calcs |
 | `seed` | Any string (deterministic) | `"user-42"`, `"session-abc-123"`, email hash | Numbers, objects - must be string |
 | `number` (angel numbers path) | String | `"1111"`, `"777"`, `"1234"` | `1111` (int) fails path validation |
 | `id` (nakshatra / dream / tarot) | Slug | `"ashwini"`, `"flying"`, `"the-fool"`, `"three-of-cups"` | Display names, uppercase, spaces |
 | `houseSystem` | Enum | `"placidus"` (default), `"whole-sign"`, `"equal"`, `"koch"` | `"Placidus"`, `"whole_sign"`, `"WS"` |
 | `ayanamsa` (KP) | Enum | `"kp-newcomb"` (default), `"kp-old"`, `"lahiri"`, `"custom"` | `"KP"`, `"New Comb"`, `"Lahiri"` |
-| `nodeType` | Enum | `"true-node"`, `"mean-node"` | `"true"`, `"mean"`, `"True Node"` |
+| `nodeType` (KP) | Enum | `"mean"` (default, traditional Vedic), `"true"` (osculating with perturbation corrections) | `"true-node"`, `"mean-node"`, `"True Node"` |
 | `count` (tarot draw) | Integer 1 to 78 | `3`, `10`, `78` | `0`, `79`, strings, floats |
 | `mahadasha` (path) | Planet name | `"Ketu"`, `"Venus"`, `"Sun"`, `"Moon"`, `"Mars"`, `"Rahu"`, `"Jupiter"`, `"Saturn"`, `"Mercury"` | `"KETU"` (works, case-insensitive), `"ke"`, `"Ke-tu"` |
 | `person1` / `person2` | Object with full birth data | `{ date, time, latitude, longitude, timezone }` (Western) or `{ date, time, latitude, longitude }` (Vedic) | Separate top-level fields, missing time, partial object |
@@ -229,7 +240,7 @@ LLMs hallucinate confidently in this category. These are the specific traps you
 
 - **Ayanamsa is server-side in Vedic.** LLMs default to tropical / Western math. Vedic endpoints apply sidereal Lahiri ayanamsa server-side. KP endpoints accept `ayanamsa` of `kp-newcomb` (default), `kp-old`, `lahiri`, or `custom`. Do not try to "correct" server output by subtracting ayanamsa in client code.
 - **Tithi count is 30, not 2.** 15 Shukla (waxing) plus 15 Krishna (waning). Older LLM training data conflates Purnima and Amavasya as single tithis. Our panchang response carries a `paksha` field (`"Shukla"` or `"Krishna"`) plus a tithi number, so there are 30 distinct tithis in a lunar month.
-- **Rahu and Ketu are shadow points, not planets.** They do not appear in a real ephemeris. Endpoints accept `nodeType` of `true-node` or `mean-node` to select which calculation to use.
+- **Rahu and Ketu are shadow points, not planets.** They do not appear in a real ephemeris. Endpoints accept `nodeType` of `"mean"` (smooth mean node, traditional Vedic default) or `"true"` (osculating node with perturbation corrections) to select which calculation to use.
 - **Nakshatra count is 27.** Abhijit is sometimes treated as a 28th in some schools, but this API uses the standard 27. `roxy.vedicAstrology.listNakshatras()` returns an array of length 27.
 - **Retrograde is per-planet, not global.** Natal chart planets and Vedic `meta` include `isRetrograde: boolean` per planet. KP planet lists use `retrograde`. Never generate "Mercury retrograde globally" UI copy, check the specific planet in the response.
 - **Tarot reversals are a product choice.** `allowReversals: false` on a tarot draw means no reversed cards in that draw, period. It is not cosmically meaningful, it is a config flag.

package/README.md

@@ -85,18 +85,18 @@ const { latitude, longitude, timezone } = data.cities[0];
 <!-- BEGIN:DOMAINS -->
 | Namespace | Endpoints | What it covers |
 |-----------|-----------|----------------|
-| `roxy.astrology` | 22 | Western astrology: natal charts, horoscopes, synastry, moon phases |
-| `roxy.vedicAstrology` | 42 | Vedic/Jyotish: birth charts, dashas, nakshatras, panchang, KP system |
-| `roxy.numerology` | 16 | Life path, expression, soul urge, personal year, karmic lessons |
-| `roxy.tarot` | 10 | 78-card readings: spreads, daily pulls, yes/no, Celtic Cross |
-| `roxy.biorhythm` | 6 | 10-cycle biorhythm readings, forecasts, critical days, compatibility |
-| `roxy.iching` | 9 | I Ching hexagrams, trigrams, daily readings |
-| `roxy.crystals` | 12 | Crystal meanings, healing properties, zodiac and chakra pairings |
-| `roxy.dreams` | 5 | Dream symbol dictionary: 3,000+ interpretations |
-| `roxy.angelNumbers` | 4 | Angel number lookup, pattern analysis, daily guidance |
-| `roxy.location` | 3 | City and country search for birth chart coordinates |
-| `roxy.usage` | 1 | API usage stats, rate limits, subscription info |
-| `roxy.languages` | 1 | List supported response languages for the lang query parameter |
+| `roxy.astrology` | 22 | Production-ready Western astrology API + remote MCP for AI agents and developers |
+| `roxy.vedicAstrology` | 42 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
+| `roxy.numerology` | 16 | Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers |
+| `roxy.tarot` | 10 | Production-ready tarot card reading API + hosted MCP for AI agents and developers |
+| `roxy.biorhythm` | 6 | The most complete biorhythm API + remote MCP for AI agents and developers |
+| `roxy.iching` | 9 | I-Ching oracle API + hosted MCP for AI agents and developers |
+| `roxy.crystals` | 12 | Production-ready crystal healing API + hosted MCP for AI agents and developers |
+| `roxy.dreams` | 5 | Dream interpretation API + hosted MCP for AI agents and developers |
+| `roxy.angelNumbers` | 4 | Production-ready angel numbers API + hosted MCP for AI agents and developers |
+| `roxy.location` | 3 | City search and geocoding API + hosted MCP for AI agents and astrology apps |
+| `roxy.usage` | 1 | Monitor your API usage, check rate limits, and track request consumption |
+| `roxy.languages` | 1 | List the response languages accepted by the `lang` query parameter on every i18n-aware endpoint |
 <!-- END:DOMAINS -->
 
 ## Most-used endpoints
@@ -124,7 +124,7 @@ const { data: synastry } = await roxy.astrology.calculateSynastry({
     person2: { date: '1992-07-22', time: '09:00:00', latitude: 19.07, longitude: 72.87, timezone: 5.5 },
   },
 });
-// synastry.compatibilityScore, synastry.interAspects, synastry.strengths
+// synastry.compatibilityScore, synastry.interAspects, synastry.analysis.strengths
 
 // Moon phase. Viral for wellness, cycle-tracking, and meditation apps.
 const { data: moon } = await roxy.astrology.getCurrentMoonPhase({});
@@ -198,7 +198,7 @@ High search volume, evergreen. The tarot card database is the highest per-endpoi
 ```typescript
 // Daily card. Stickiest tarot feature. Seed per user for deterministic once-per-day behavior.
 const { data: card } = await roxy.tarot.getDailyCard({ body: { seed: 'user-42' } });
-// card.card.name, card.card.imageUrl, card.interpretation
+// card.card.name, card.card.imageUrl, card.dailyMessage
 
 // Celtic Cross. Professional-reader spread. Premium-tier, ten positions.
 const { data: cc } = await roxy.tarot.castCelticCross({
@@ -252,10 +252,10 @@ Crystal retail and metaphysical shops use these to build "crystals for [sign]" a
 ```typescript
 // By zodiac. Highest-search crystal query pattern.
 const { data: bySign } = await roxy.crystals.getCrystalsByZodiac({ path: { sign: 'scorpio' } });
-// bySign.crystals is a list of id, name, color, chakra, properties
+// bySign.crystals is a list of { id, name, imageUrl, colors }. Use /crystals/{id} for full properties.
 
 // By chakra. Second-highest crystal query pattern.
-const { data: byChakra } = await roxy.crystals.getCrystalsByChakra({ path: { chakra: 'heart' } });
+const { data: byChakra } = await roxy.crystals.getCrystalsByChakra({ path: { chakra: 'Heart' } });
 
 // Birthstone. Evergreen gift and jewelry SEO.
 const { data: birthstone } = await roxy.crystals.getBirthstones({ path: { month: 4 } });

package/dist/factory.cjs

@@ -2721,7 +2721,7 @@ var Location = class extends HeyApiClient {
   /**
    * Search cities worldwide - Geocoding autocomplete with coordinates and timezone
    *
-   * City autocomplete and geocoding search across 7,000+ locations in 227 countries. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Covers all major cities in Europe, Americas, Asia, Africa, and Oceania.
+   * City autocomplete and geocoding search across 23,000+ locations in 240+ countries, including deep coverage of Indian tier-2 and tier-3 cities. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Common alternate names like Bombay, Calcutta, Madras, and Banaras transparently resolve to their canonical entries.
    */
   searchCities(options) {
     return (options.client ?? this.client).get({
@@ -2731,9 +2731,9 @@ var Location = class extends HeyApiClient {
     });
   }
   /**
-   * List all 227 countries - ISO codes and city coverage
+   * List all countries - ISO codes and city coverage
    *
-   * Returns all 227 countries with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
+   * Returns every country with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
    */
   listCountries(options) {
     return (options?.client ?? this.client).get({
@@ -2840,7 +2840,7 @@ var Roxy = class _Roxy extends HeyApiClient {
 };
 
 // src/version.ts
-var VERSION = "1.2.23";
+var VERSION = "1.2.25";
 
 // src/factory.ts
 function createRoxy(auth) {

package/dist/factory.js

@@ -1885,7 +1885,7 @@ var Location = class extends HeyApiClient {
   /**
    * Search cities worldwide - Geocoding autocomplete with coordinates and timezone
    *
-   * City autocomplete and geocoding search across 7,000+ locations in 227 countries. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Covers all major cities in Europe, Americas, Asia, Africa, and Oceania.
+   * City autocomplete and geocoding search across 23,000+ locations in 240+ countries, including deep coverage of Indian tier-2 and tier-3 cities. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Common alternate names like Bombay, Calcutta, Madras, and Banaras transparently resolve to their canonical entries.
    */
   searchCities(options) {
     return (options.client ?? this.client).get({
@@ -1895,9 +1895,9 @@ var Location = class extends HeyApiClient {
     });
   }
   /**
-   * List all 227 countries - ISO codes and city coverage
+   * List all countries - ISO codes and city coverage
    *
-   * Returns all 227 countries with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
+   * Returns every country with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
    */
   listCountries(options) {
     return (options?.client ?? this.client).get({
@@ -2004,7 +2004,7 @@ var Roxy = class _Roxy extends HeyApiClient {
 };
 
 // src/version.ts
-var VERSION = "1.2.23";
+var VERSION = "1.2.25";
 
 // src/factory.ts
 function createRoxy(auth) {

package/dist/sdk.gen.d.ts

@@ -803,13 +803,13 @@ export declare class Location extends HeyApiClient {
     /**
      * Search cities worldwide - Geocoding autocomplete with coordinates and timezone
      *
-     * City autocomplete and geocoding search across 7,000+ locations in 227 countries. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Covers all major cities in Europe, Americas, Asia, Africa, and Oceania.
+     * City autocomplete and geocoding search across 23,000+ locations in 240+ countries, including deep coverage of Indian tier-2 and tier-3 cities. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Common alternate names like Bombay, Calcutta, Madras, and Banaras transparently resolve to their canonical entries.
      */
     searchCities<ThrowOnError extends boolean = false>(options: Options<GetLocationSearchData, ThrowOnError>): import("./client").RequestResult<GetLocationSearchResponses, GetLocationSearchErrors, ThrowOnError, "fields">;
     /**
-     * List all 227 countries - ISO codes and city coverage
+     * List all countries - ISO codes and city coverage
      *
-     * Returns all 227 countries with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
+     * Returns every country with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
      */
     listCountries<ThrowOnError extends boolean = false>(options?: Options<GetLocationCountriesData, ThrowOnError>): import("./client").RequestResult<GetLocationCountriesResponses, GetLocationCountriesErrors, ThrowOnError, "fields">;
     /**

package/dist/types.gen.d.ts

@@ -27210,7 +27210,7 @@ export type GetLocationCountriesData = {
     path?: never;
     query?: {
         /**
-         * Maximum items to return per page. Range: 1-50, default 50.
+         * Maximum items to return per page. Range: 1-250, default 50.
          */
         limit?: number;
         /**
@@ -27324,7 +27324,7 @@ export type GetLocationCountriesErrors = {
 export type GetLocationCountriesError = GetLocationCountriesErrors[keyof GetLocationCountriesErrors];
 export type GetLocationCountriesResponses = {
     /**
-     * Alphabetically sorted list of all 227 countries with ISO codes and city counts
+     * Alphabetically sorted list of all countries with ISO codes and city counts
      */
     200: {
         /**
@@ -27373,7 +27373,7 @@ export type GetLocationCountriesByIso2Data = {
     };
     query?: {
         /**
-         * Maximum items to return per page. Range: 1-200, default 50.
+         * Maximum items to return per page. Range: 1-100, default 20.
          */
         limit?: number;
         /**

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.2.23";
+export declare const VERSION = "1.2.25";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@roxyapi/sdk",
-	"version": "1.2.23",
+	"version": "1.2.25",
 	"description": "TypeScript SDK for Roxy — the multi-domain spiritual intelligence API",
 	"type": "module",
 	"exports": {

package/src/sdk.gen.ts

@@ -2030,7 +2030,7 @@ export class Location extends HeyApiClient {
     /**
      * Search cities worldwide - Geocoding autocomplete with coordinates and timezone
      *
-     * City autocomplete and geocoding search across 7,000+ locations in 227 countries. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Covers all major cities in Europe, Americas, Asia, Africa, and Oceania.
+     * City autocomplete and geocoding search across 23,000+ locations in 240+ countries, including deep coverage of Indian tier-2 and tier-3 cities. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Common alternate names like Bombay, Calcutta, Madras, and Banaras transparently resolve to their canonical entries.
      */
     public searchCities<ThrowOnError extends boolean = false>(options: Options<GetLocationSearchData, ThrowOnError>) {
         return (options.client ?? this.client).get<GetLocationSearchResponses, GetLocationSearchErrors, ThrowOnError>({
@@ -2041,9 +2041,9 @@ export class Location extends HeyApiClient {
     }
     
     /**
-     * List all 227 countries - ISO codes and city coverage
+     * List all countries - ISO codes and city coverage
      *
-     * Returns all 227 countries with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
+     * Returns every country with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
      */
     public listCountries<ThrowOnError extends boolean = false>(options?: Options<GetLocationCountriesData, ThrowOnError>) {
         return (options?.client ?? this.client).get<GetLocationCountriesResponses, GetLocationCountriesErrors, ThrowOnError>({

package/src/types.gen.ts

@@ -27907,7 +27907,7 @@ export type GetLocationCountriesData = {
     path?: never;
     query?: {
         /**
-         * Maximum items to return per page. Range: 1-50, default 50.
+         * Maximum items to return per page. Range: 1-250, default 50.
          */
         limit?: number;
         /**
@@ -28024,7 +28024,7 @@ export type GetLocationCountriesError = GetLocationCountriesErrors[keyof GetLoca
 
 export type GetLocationCountriesResponses = {
     /**
-     * Alphabetically sorted list of all 227 countries with ISO codes and city counts
+     * Alphabetically sorted list of all countries with ISO codes and city counts
      */
     200: {
         /**
@@ -28075,7 +28075,7 @@ export type GetLocationCountriesByIso2Data = {
     };
     query?: {
         /**
-         * Maximum items to return per page. Range: 1-200, default 50.
+         * Maximum items to return per page. Range: 1-100, default 20.
          */
         limit?: number;
         /**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.2.23';
+export const VERSION = '1.2.25';