diff --git a/CHANGELOG.md b/CHANGELOG.md index e4c4d42..0501122 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,17 @@ +# [4.3.0-beta.2](https://github.com/ideal-postcodes/openapi/compare/4.3.0-beta.1...4.3.0-beta.2) (2024-02-19) + + +### Bug Fixes + +* **USPS:** Add missing countries ([5ba5418](https://github.com/ideal-postcodes/openapi/commit/5ba5418cd3646551c4ab4b99d44517a7731b1ea9)) + +# [4.3.0-beta.1](https://github.com/ideal-postcodes/openapi/compare/4.2.1...4.3.0-beta.1) (2024-01-23) + + +### Features + +* **Rest of World:** Add additional countries ([dd13654](https://github.com/ideal-postcodes/openapi/commit/dd13654b0499e8c76dcce6c3f06906476b3dc093)) + ## [4.2.1](https://github.com/ideal-postcodes/openapi/compare/4.2.0...4.2.1) (2023-11-29) diff --git a/dist/openapi.json b/dist/openapi.json index 5732712..4b9ba32 100644 --- a/dist/openapi.json +++ b/dist/openapi.json @@ -761,6 +761,21 @@ "type": "string", "description": "Freeform address input to cleanse\n", "example": "10 Downing Street, London, SW2A 2BN" + }, + "postcode": { + "type": "string", + "description": "Optionally specify postal code for the address.\n", + "example": "SW1A 2BN" + }, + "post_town": { + "type": "string", + "description": "Optionally specify the city or town of the address.\n\nFor UK verifications, this should be the \"post town\" of the address.\n\nFor USA verifications, this should be the city of the address.\n", + "example": "London" + }, + "county": { + "type": "string", + "description": "Optionally specify the county or state of the address.\n\nFor UK verifications, we recommend omitting this field as county data is unreliable.\n\nFor USA verifications, this should be the state of the address.\n", + "example": "Kent" } } } @@ -3648,6 +3663,7 @@ "heresa", "hereo", "herena", + "heremeas", "heremea", "herem", "herei", @@ -3819,7 +3835,94 @@ "TTO", "URY", "VEN", - "TWN" + "TWN", + "CHN", + "JPN", + "KOR", + "LAO", + "MNG", + "PNG", + "PRK", + "SLB", + "TJK", + "TKM", + "BTN", + "IOT", + "LKA", + "MDV", + "NPL", + "PAK", + "AFG", + "BDI", + "BEN", + "CAF", + "CIV", + "COD", + "COG", + "COM", + "CPV", + "DJI", + "DZA", + "ERI", + "ESH", + "ETH", + "GAB", + "GIN", + "GMB", + "GNB", + "GNQ", + "IRN", + "IRQ", + "LBR", + "LBY", + "MDG", + "MLI", + "MRT", + "MWI", + "NER", + "RWA", + "SHN", + "SLE", + "SOM", + "SSD", + "STP", + "SYC", + "TCD", + "TGO", + "TZA", + "UGA", + "SDN", + "SYR", + "YEM", + "CUB", + "SPM", + "TCA", + "COK", + "KIR", + "NIU", + "NRU", + "PCN", + "TKL", + "TUV", + "WLF", + "WSM", + "AIA", + "ATG", + "BES", + "FLK", + "GRD", + "KNA", + "LCA", + "MSR", + "SGS", + "SXM", + "VCT", + "ASM", + "FSM", + "MHL", + "MNP", + "PLW", + "VIR" ] }, "CountryISO2": { @@ -3985,7 +4088,93 @@ "TN", "ZA", "ZM", - "ZW" + "ZW", + "CN", + "JP", + "KR", + "LA", + "MN", + "PG", + "KP", + "SB", + "TJ", + "TM", + "BT", + "IO", + "LK", + "MV", + "NP", + "PK", + "AF", + "BI", + "BJ", + "CF", + "CI", + "CD", + "CG", + "KM", + "CV", + "DJ", + "DZ", + "ER", + "EH", + "ET", + "GA", + "GN", + "GM", + "GW", + "GQ", + "IR", + "IQ", + "LR", + "LY", + "MG", + "ML", + "MR", + "MW", + "NE", + "RW", + "SH", + "SL", + "SO", + "SS", + "ST", + "SC", + "TD", + "TG", + "TZ", + "UG", + "SD", + "SY", + "YE", + "CU", + "PM", + "TC", + "CK", + "KI", + "NU", + "NR", + "PN", + "TK", + "TV", + "WF", + "WS", + "AI", + "AG", + "BQ", + "FK", + "KN", + "LC", + "MS", + "GS", + "SX", + "VC", + "AS", + "FM", + "MH", + "MP", + "PW", + "VI" ] }, "Country": { @@ -4155,7 +4344,94 @@ "Tunisia", "South Africa", "Zambia", - "Zimbabwe" + "Zimbabwe", + "China", + "Japan", + "South Korea", + "Laos", + "Mongolia", + "Papua New Guinea", + "North Korea", + "Solomon Islands", + "Tajikistan", + "Turkmenistan", + "Bhutan", + "British Indian Ocean Territory", + "Sri Lanka", + "Maldives", + "Nepal", + "Pakistan", + "Afghanistan", + "Burundi", + "Benin", + "Central African Republic", + "Côte d'Ivoire", + "Democratic Republic of the Congo", + "Republic of the Congo", + "Comoros", + "Cape Verde", + "Djibouti", + "Algeria", + "Eritrea", + "Western Sahara", + "Ethiopia", + "Gabon", + "Guinea", + "Gambia", + "Guinea-Bissau", + "Equatorial Guinea", + "Iran", + "Iraq", + "Liberia", + "Libya", + "Madagascar", + "Mali", + "Mauritania", + "Malawi", + "Niger", + "Rwanda", + "Saint Helena", + "Sierra Leone", + "Somalia", + "South Sudan", + "São Tomé and Príncipe", + "Seychelles", + "Chad", + "Togo", + "Tanzania", + "Uganda", + "Sudan", + "Syria", + "Yemen", + "Cuba", + "Saint Pierre and Miquelon", + "Turks and Caicos Islands", + "Cook Islands", + "Kiribati", + "Niue", + "Nauru", + "Pitcairn Islands", + "Tokelau", + "Tuvalu", + "Vanuatu", + "Wallis and Futuna", + "Samoa", + "Anguilla", + "Antigua and Barbuda", + "Bonaire, Sint Eustatius and Saba", + "Falkland Islands (Malvinas)", + "Saint Kitts and Nevis", + "Saint Lucia", + "Montserrat", + "South Georgia and the South Sandwich Islands", + "Sint Maarten (Dutch part)", + "Saint Vincent and the Grenadines", + "American Samoa", + "Federated States of Micronesia", + "Marshall Islands", + "Northern Mariana Islands", + "Palau", + "United States Virgin Islands" ] }, "EircBase": { @@ -4689,9 +4965,15 @@ "type": "string", "description": " Full country names (ISO 3166)\n", "enum": [ - "United States", + "American Samoa", + "Federated States of Micronesia", "Guam", - "Puerto Rico" + "Marshall Islands", + "Northern Mariana Islands", + "Palau", + "Puerto Rico", + "United States", + "United States Virgin Islands" ] }, "usps_country_iso": { @@ -4699,9 +4981,15 @@ "type": "string", "description": " 3 letter country code (ISO 3166-1)\n", "enum": [ - "USA", + "ASM", + "FSM", + "GUM", + "MHL", + "MNP", + "PLW", "PRI", - "GUM" + "USA", + "VIR" ] }, "usps_country_iso_2": { @@ -4709,9 +4997,15 @@ "type": "string", "description": " 2 letter country code (ISO 3166-1)\n", "enum": [ - "US", + "AS", + "FM", + "GU", + "MH", + "MP", "PR", - "GU" + "PW", + "US", + "VI" ] }, "usps_language": { @@ -5242,6 +5536,7 @@ "heresa", "hereo", "herena", + "heremeas", "heremea", "herem", "herei", @@ -5305,18 +5600,34 @@ "example": "1" }, "delivery_latitude": { - "type": "number", - "description": "Latitude defining the arrival position of the Point Address.", - "example": 45.28447, - "minimum": -90, - "maximum": 90 + "oneOf": [ + { + "type": "string", + "description": "Empty string `\"\"` if not available" + }, + { + "type": "number", + "minimum": -90, + "maximum": 90, + "description": "Latitude defining the arrival position of the Point Address.", + "example": 45.28441 + } + ] }, "delivery_longitude": { - "type": "number", - "description": "Longitude defining the arrival position of the Point Address.", - "example": 12.00821, - "minimum": -180, - "maximum": 180 + "oneOf": [ + { + "type": "string", + "description": "Empty string `\"\"` if not available" + }, + { + "type": "number", + "minimum": -180, + "maximum": 180, + "description": "Longitude defining the arrival position of the Point Address.", + "example": 12.00825 + } + ] }, "building_name": { "type": "string", @@ -5335,7 +5646,7 @@ "type": "number", "minimum": -90, "maximum": 90, - "description": "Latitude of the display position for the Point Address.\nCan be empty string `\"\"` if not present.", + "description": "Latitude of the display position for the Point Address.", "example": 45.28441 } ] @@ -6922,12 +7233,14 @@ "herei", "herem", "heremea", + "heremeas", "herena", "hereo", "heresa", "heret", "email", - "phone" + "phone", + "gnaf" ], "properties": { "paf": { @@ -7010,6 +7323,11 @@ "description": "Middle East and Africa Address File", "example": true }, + "heremeas": { + "type": "boolean", + "description": "Middle East and Africa Standalone Intermediate Maps Address File", + "example": true + }, "herena": { "type": "boolean", "description": "North America Address File", @@ -7308,6 +7626,11 @@ "description": "Middle East and Africa Address File", "example": true }, + "heremeas": { + "type": "boolean", + "description": "Middle East and Africa Extended File", + "example": true + }, "herena": { "type": "boolean", "description": "North America Address File", @@ -7347,6 +7670,11 @@ "type": "boolean", "description": "Email validation is enabled", "example": true + }, + "gnaf": { + "type": "boolean", + "description": "Australia Geoscape Geocoded National Address File", + "example": true } } } @@ -7429,6 +7757,292 @@ } } }, + "UsaCassVerifiedAddress": { + "title": "United States CASS Verified Address", + "type": "object", + "description": "Address retrieved using CASS compliant address verification process\n", + "required": [ + "address1", + "address2", + "address3", + "area_code", + "carrier_route", + "check_digit", + "city", + "city_abbreviation", + "congressional_district", + "country_code", + "county", + "day_light_savings", + "delivery_point", + "dpv", + "dpv_cmra", + "dpv_footnotes", + "dpv_fp", + "dpv_no_stat", + "dpv_vacant", + "elot", + "finance_number", + "fips_county_code", + "firm", + "footnotes", + "geo_coded", + "lacs_indicator", + "lacs_link_footnote", + "lacs_link_indicator", + "latitude", + "longitude", + "parsed_pmb_designator", + "parsed_pmb_number", + "parsed_post_directional", + "parsed_pre_directional", + "parsed_primary_number", + "parsed_street_name", + "parsed_suffix", + "parsed_unit_designator", + "parsed_unit_number", + "rdi", + "record_type", + "secondary_address_info", + "state", + "suite_link_footnote", + "time_zone", + "urbanization", + "zip_code" + ], + "properties": { + "address1": { + "type": "string", + "description": "Primary delivery address\n" + }, + "address2": { + "type": "string", + "description": "Secondary address information\n" + }, + "address3": { + "type": "string", + "description": "Additional secondary address information\n" + }, + "area_code": { + "type": "string", + "description": "Area code\n" + }, + "carrier_route": { + "type": "string", + "description": "Data required to perform a Carrier Route sort\n" + }, + "check_digit": { + "type": "string", + "description": "Character following the 5- or 9-digit ZIP Code\n" + }, + "city": { + "type": "string", + "description": "City name\n" + }, + "city_abbreviation": { + "type": "string", + "description": "City Abbreviation. Empty string if not present\n" + }, + "congressional_district": { + "type": "string", + "description": "Identifies the Congressional District. Empty string if not present\n" + }, + "country_code": { + "type": "string", + "description": "ISO3166 country code. Empty string if not present\n" + }, + "county": { + "type": "string", + "description": "Name of the county\n" + }, + "day_light_savings": { + "type": "string", + "description": "Daylight saving time indicator\n" + }, + "delivery_point": { + "type": "string", + "description": "Last 2 digits of the primary street address number or Post Office™ box\n" + }, + "dpv": { + "type": "string", + "description": "DPV Confirmation code. Possible values: 'Y' (Yes), 'S' (Suspicious), 'D' (No).\n" + }, + "dpv_cmra": { + "type": "string", + "description": "DPV CMRA code. Possible values: 'Y' (Yes), 'N' (No).\n" + }, + "dpv_footnotes": { + "type": "string", + "description": "DPV Footnotes. Empty string if not present\n" + }, + "dpv_fp": { + "type": "string", + "description": "False Positive Indicator from the DPV lookup. Possible values: 'Y' (Yes), 'N' (No), ' ' (Space). Empty string if not present\n" + }, + "dpv_no_stat": { + "type": "string", + "description": "DPV NoStat code. Empty string if not present\n" + }, + "dpv_vacant": { + "type": "string", + "description": "DPV Vacant code. Empty string if not present\n" + }, + "elot": { + "type": "string", + "description": "Enhanced Line of Travel\n" + }, + "finance_number": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "number" + } + ], + "description": "Internal accounting number used by the USPS. Empty string if not present\n" + }, + "fips_county_code": { + "type": "string", + "description": "Federal Information Processing Standard code for a county. Empty string if not present\n" + }, + "firm": { + "type": "string", + "description": "Company name in a business address\n" + }, + "footnotes": { + "type": "string", + "description": "Letter codes returned by ZIP + 4® encoding. Empty string if not present\n" + }, + "geo_coded": { + "type": "string", + "description": "Indicates whether the address was geo-coded. Possible values: 'Y' (Yes), 'N' (No).\n" + }, + "lacs_indicator": { + "type": "string", + "description": "Indicates whether a record may benefit from LACS processing. Possible values: 'L' (Yes), ' ' (No).\n" + }, + "lacs_link_footnote": { + "type": "string", + "description": "LACSLink Footnote. Empty string if not present\n" + }, + "lacs_link_indicator": { + "type": "string", + "description": "LACSLink Indicator. Empty string if not present\n" + }, + "latitude": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "number" + } + ], + "description": "Latitude of the encoded address. Empty string if not present\n" + }, + "longitude": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "number" + } + ], + "description": "Longitude of the encoded address. Empty string if not present\n" + }, + "parsed_pmb_designator": { + "type": "string", + "description": "Information if a PMB is found in an address. Empty string if not present\n" + }, + "parsed_pmb_number": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "number" + } + ], + "description": "Information if a PMB is found in an address. Empty string if not present\n" + }, + "parsed_post_directional": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "number" + } + ], + "description": "Notation following the street name indicating street direction. Empty string if not present\n" + }, + "parsed_pre_directional": { + "type": "string", + "description": "Notation preceding the street name indicating street direction. Empty string if not present\n" + }, + "parsed_primary_number": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "number" + } + ], + "description": "Number preceding the street name. Empty string if not present\n" + }, + "parsed_street_name": { + "type": "string", + "description": "Street name. Empty string if not present\n" + }, + "parsed_suffix": { + "type": "string", + "description": "Part of the delivery address line following the street name. Empty string if not present\n" + }, + "parsed_unit_designator": { + "type": "string", + "description": "Identification of the secondary address unit. Empty string if not present\n" + }, + "parsed_unit_number": { + "type": "string", + "description": "Apartment or suite number. Empty string if not present\n" + }, + "rdi": { + "type": "string", + "description": "Reserved for future use. Empty string if not present\n" + }, + "record_type": { + "type": "string", + "description": "Type of address record (Street, PO Box, High-rise, etc.)\n" + }, + "secondary_address_info": { + "type": "string", + "description": "Additional secondary address information. Empty string if not present\n" + }, + "state": { + "type": "string", + "description": "Standard two-letter state abbreviation\n" + }, + "suite_link_footnote": { + "type": "string", + "description": "Results of the SuiteLink lookup. Possible values: ' ' (Space), '00' (Double Zero), 'A' (A). Empty string if not present\n" + }, + "time_zone": { + "type": "string", + "description": "Time zone. Empty string if not present\n" + }, + "urbanization": { + "type": "string", + "description": "Urban name required in the address of all mail being delivered to Puerto Rico. Empty string if not present\n" + }, + "zip_code": { + "type": "string", + "description": "5-digit ZIP Code™ and the four additional digits\n" + } + } + }, "GbrCleanseMatch": { "title": "Address Match", "type": "object", @@ -7467,6 +8081,9 @@ }, { "$ref": "#/components/schemas/WelshPafAddress" + }, + { + "$ref": "#/components/schemas/UsaCassVerifiedAddress" } ] }, diff --git a/dist/openapi.yaml b/dist/openapi.yaml index 2a6b45b..3a89d44 100644 --- a/dist/openapi.yaml +++ b/dist/openapi.yaml @@ -809,6 +809,29 @@ paths: description: | Freeform address input to cleanse example: 10 Downing Street, London, SW2A 2BN + postcode: + type: string + description: | + Optionally specify postal code for the address. + example: SW1A 2BN + post_town: + type: string + description: | + Optionally specify the city or town of the address. + + For UK verifications, this should be the "post town" of the address. + + For USA verifications, this should be the city of the address. + example: London + county: + type: string + description: | + Optionally specify the county or state of the address. + + For UK verifications, we recommend omitting this field as county data is unreliable. + + For USA verifications, this should be the state of the address. + example: Kent responses: '200': description: Success @@ -3049,6 +3072,7 @@ components: - heresa - hereo - herena + - heremeas - heremea - herem - herei @@ -3220,6 +3244,93 @@ components: - URY - VEN - TWN + - CHN + - JPN + - KOR + - LAO + - MNG + - PNG + - PRK + - SLB + - TJK + - TKM + - BTN + - IOT + - LKA + - MDV + - NPL + - PAK + - AFG + - BDI + - BEN + - CAF + - CIV + - COD + - COG + - COM + - CPV + - DJI + - DZA + - ERI + - ESH + - ETH + - GAB + - GIN + - GMB + - GNB + - GNQ + - IRN + - IRQ + - LBR + - LBY + - MDG + - MLI + - MRT + - MWI + - NER + - RWA + - SHN + - SLE + - SOM + - SSD + - STP + - SYC + - TCD + - TGO + - TZA + - UGA + - SDN + - SYR + - YEM + - CUB + - SPM + - TCA + - COK + - KIR + - NIU + - NRU + - PCN + - TKL + - TUV + - WLF + - WSM + - AIA + - ATG + - BES + - FLK + - GRD + - KNA + - LCA + - MSR + - SGS + - SXM + - VCT + - ASM + - FSM + - MHL + - MNP + - PLW + - VIR CountryISO2: title: ISO Country Code (2) type: string @@ -3385,6 +3496,92 @@ components: - ZA - ZM - ZW + - CN + - JP + - KR + - LA + - MN + - PG + - KP + - SB + - TJ + - TM + - BT + - IO + - LK + - MV + - NP + - PK + - AF + - BI + - BJ + - CF + - CI + - CD + - CG + - KM + - CV + - DJ + - DZ + - ER + - EH + - ET + - GA + - GN + - GM + - GW + - GQ + - IR + - IQ + - LR + - LY + - MG + - ML + - MR + - MW + - NE + - RW + - SH + - SL + - SO + - SS + - ST + - SC + - TD + - TG + - TZ + - UG + - SD + - SY + - YE + - CU + - PM + - TC + - CK + - KI + - NU + - NR + - PN + - TK + - TV + - WF + - WS + - AI + - AG + - BQ + - FK + - KN + - LC + - MS + - GS + - SX + - VC + - AS + - FM + - MH + - MP + - PW + - VI Country: title: Country type: string @@ -3554,6 +3751,93 @@ components: - South Africa - Zambia - Zimbabwe + - China + - Japan + - South Korea + - Laos + - Mongolia + - Papua New Guinea + - North Korea + - Solomon Islands + - Tajikistan + - Turkmenistan + - Bhutan + - British Indian Ocean Territory + - Sri Lanka + - Maldives + - Nepal + - Pakistan + - Afghanistan + - Burundi + - Benin + - Central African Republic + - Côte d'Ivoire + - Democratic Republic of the Congo + - Republic of the Congo + - Comoros + - Cape Verde + - Djibouti + - Algeria + - Eritrea + - Western Sahara + - Ethiopia + - Gabon + - Guinea + - Gambia + - Guinea-Bissau + - Equatorial Guinea + - Iran + - Iraq + - Liberia + - Libya + - Madagascar + - Mali + - Mauritania + - Malawi + - Niger + - Rwanda + - Saint Helena + - Sierra Leone + - Somalia + - South Sudan + - São Tomé and Príncipe + - Seychelles + - Chad + - Togo + - Tanzania + - Uganda + - Sudan + - Syria + - Yemen + - Cuba + - Saint Pierre and Miquelon + - Turks and Caicos Islands + - Cook Islands + - Kiribati + - Niue + - Nauru + - Pitcairn Islands + - Tokelau + - Tuvalu + - Vanuatu + - Wallis and Futuna + - Samoa + - Anguilla + - Antigua and Barbuda + - Bonaire, Sint Eustatius and Saba + - Falkland Islands (Malvinas) + - Saint Kitts and Nevis + - Saint Lucia + - Montserrat + - South Georgia and the South Sandwich Islands + - Sint Maarten (Dutch part) + - Saint Vincent and the Grenadines + - American Samoa + - Federated States of Micronesia + - Marshall Islands + - Northern Mariana Islands + - Palau + - United States Virgin Islands EircBase: required: - id @@ -4111,27 +4395,45 @@ components: description: |2 Full country names (ISO 3166) enum: - - United States + - American Samoa + - Federated States of Micronesia - Guam + - Marshall Islands + - Northern Mariana Islands + - Palau - Puerto Rico + - United States + - United States Virgin Islands usps_country_iso: title: ISO Country Code (3) type: string description: |2 3 letter country code (ISO 3166-1) enum: - - USA - - PRI + - ASM + - FSM - GUM + - MHL + - MNP + - PLW + - PRI + - USA + - VIR usps_country_iso_2: title: ISO Country Code (2) type: string description: |2 2 letter country code (ISO 3166-1) enum: - - US - - PR + - AS + - FM - GU + - MH + - MP + - PR + - PW + - US + - VI usps_language: title: Language type: string @@ -4596,6 +4898,7 @@ components: - heresa - hereo - herena + - heremeas - heremea - herem - herei @@ -4670,17 +4973,23 @@ components: Can be empty string `""` if not present. example: '1' delivery_latitude: - type: number - description: Latitude defining the arrival position of the Point Address. - example: 45.28447 - minimum: -90 - maximum: 90 + oneOf: + - type: string + description: Empty string `""` if not available + - type: number + minimum: -90 + maximum: 90 + description: Latitude defining the arrival position of the Point Address. + example: 45.28441 delivery_longitude: - type: number - description: Longitude defining the arrival position of the Point Address. - example: 12.00821 - minimum: -180 - maximum: 180 + oneOf: + - type: string + description: Empty string `""` if not available + - type: number + minimum: -180 + maximum: 180 + description: Longitude defining the arrival position of the Point Address. + example: 12.00825 building_name: type: string description: | @@ -4697,9 +5006,7 @@ components: - type: number minimum: -90 maximum: 90 - description: |- - Latitude of the display position for the Point Address. - Can be empty string `""` if not present. + description: Latitude of the display position for the Point Address. example: 45.28441 longitude: oneOf: @@ -5980,12 +6287,14 @@ components: - herei - herem - heremea + - heremeas - herena - hereo - heresa - heret - email - phone + - gnaf properties: paf: type: boolean @@ -6051,6 +6360,10 @@ components: type: boolean description: Middle East and Africa Address File example: true + heremeas: + type: boolean + description: Middle East and Africa Standalone Intermediate Maps Address File + example: true herena: type: boolean description: North America Address File @@ -6292,6 +6605,10 @@ components: type: boolean description: Middle East and Africa Address File example: true + heremeas: + type: boolean + description: Middle East and Africa Extended File + example: true herena: type: boolean description: North America Address File @@ -6324,6 +6641,10 @@ components: type: boolean description: Email validation is enabled example: true + gnaf: + type: boolean + description: Australia Geoscape Geocoded National Address File + example: true KeyUsageResult: title: Key Usage type: object @@ -6382,6 +6703,260 @@ components: type: string enum: - Success + UsaCassVerifiedAddress: + title: United States CASS Verified Address + type: object + description: | + Address retrieved using CASS compliant address verification process + required: + - address1 + - address2 + - address3 + - area_code + - carrier_route + - check_digit + - city + - city_abbreviation + - congressional_district + - country_code + - county + - day_light_savings + - delivery_point + - dpv + - dpv_cmra + - dpv_footnotes + - dpv_fp + - dpv_no_stat + - dpv_vacant + - elot + - finance_number + - fips_county_code + - firm + - footnotes + - geo_coded + - lacs_indicator + - lacs_link_footnote + - lacs_link_indicator + - latitude + - longitude + - parsed_pmb_designator + - parsed_pmb_number + - parsed_post_directional + - parsed_pre_directional + - parsed_primary_number + - parsed_street_name + - parsed_suffix + - parsed_unit_designator + - parsed_unit_number + - rdi + - record_type + - secondary_address_info + - state + - suite_link_footnote + - time_zone + - urbanization + - zip_code + properties: + address1: + type: string + description: | + Primary delivery address + address2: + type: string + description: | + Secondary address information + address3: + type: string + description: | + Additional secondary address information + area_code: + type: string + description: | + Area code + carrier_route: + type: string + description: | + Data required to perform a Carrier Route sort + check_digit: + type: string + description: | + Character following the 5- or 9-digit ZIP Code + city: + type: string + description: | + City name + city_abbreviation: + type: string + description: | + City Abbreviation. Empty string if not present + congressional_district: + type: string + description: | + Identifies the Congressional District. Empty string if not present + country_code: + type: string + description: | + ISO3166 country code. Empty string if not present + county: + type: string + description: | + Name of the county + day_light_savings: + type: string + description: | + Daylight saving time indicator + delivery_point: + type: string + description: | + Last 2 digits of the primary street address number or Post Office™ box + dpv: + type: string + description: | + DPV Confirmation code. Possible values: 'Y' (Yes), 'S' (Suspicious), 'D' (No). + dpv_cmra: + type: string + description: | + DPV CMRA code. Possible values: 'Y' (Yes), 'N' (No). + dpv_footnotes: + type: string + description: | + DPV Footnotes. Empty string if not present + dpv_fp: + type: string + description: | + False Positive Indicator from the DPV lookup. Possible values: 'Y' (Yes), 'N' (No), ' ' (Space). Empty string if not present + dpv_no_stat: + type: string + description: | + DPV NoStat code. Empty string if not present + dpv_vacant: + type: string + description: | + DPV Vacant code. Empty string if not present + elot: + type: string + description: | + Enhanced Line of Travel + finance_number: + oneOf: + - type: string + - type: number + description: | + Internal accounting number used by the USPS. Empty string if not present + fips_county_code: + type: string + description: | + Federal Information Processing Standard code for a county. Empty string if not present + firm: + type: string + description: | + Company name in a business address + footnotes: + type: string + description: | + Letter codes returned by ZIP + 4® encoding. Empty string if not present + geo_coded: + type: string + description: | + Indicates whether the address was geo-coded. Possible values: 'Y' (Yes), 'N' (No). + lacs_indicator: + type: string + description: | + Indicates whether a record may benefit from LACS processing. Possible values: 'L' (Yes), ' ' (No). + lacs_link_footnote: + type: string + description: | + LACSLink Footnote. Empty string if not present + lacs_link_indicator: + type: string + description: | + LACSLink Indicator. Empty string if not present + latitude: + oneOf: + - type: string + - type: number + description: | + Latitude of the encoded address. Empty string if not present + longitude: + oneOf: + - type: string + - type: number + description: | + Longitude of the encoded address. Empty string if not present + parsed_pmb_designator: + type: string + description: | + Information if a PMB is found in an address. Empty string if not present + parsed_pmb_number: + oneOf: + - type: string + - type: number + description: | + Information if a PMB is found in an address. Empty string if not present + parsed_post_directional: + oneOf: + - type: string + - type: number + description: | + Notation following the street name indicating street direction. Empty string if not present + parsed_pre_directional: + type: string + description: | + Notation preceding the street name indicating street direction. Empty string if not present + parsed_primary_number: + oneOf: + - type: string + - type: number + description: | + Number preceding the street name. Empty string if not present + parsed_street_name: + type: string + description: | + Street name. Empty string if not present + parsed_suffix: + type: string + description: | + Part of the delivery address line following the street name. Empty string if not present + parsed_unit_designator: + type: string + description: | + Identification of the secondary address unit. Empty string if not present + parsed_unit_number: + type: string + description: | + Apartment or suite number. Empty string if not present + rdi: + type: string + description: | + Reserved for future use. Empty string if not present + record_type: + type: string + description: | + Type of address record (Street, PO Box, High-rise, etc.) + secondary_address_info: + type: string + description: | + Additional secondary address information. Empty string if not present + state: + type: string + description: | + Standard two-letter state abbreviation + suite_link_footnote: + type: string + description: | + Results of the SuiteLink lookup. Possible values: ' ' (Space), '00' (Double Zero), 'A' (A). Empty string if not present + time_zone: + type: string + description: | + Time zone. Empty string if not present + urbanization: + type: string + description: | + Urban name required in the address of all mail being delivered to Puerto Rico. Empty string if not present + zip_code: + type: string + description: | + 5-digit ZIP Code™ and the four additional digits GbrCleanseMatch: title: Address Match type: object @@ -6409,6 +6984,7 @@ components: - $ref: '#/components/schemas/NybAddress' - $ref: '#/components/schemas/PafAliasAddress' - $ref: '#/components/schemas/WelshPafAddress' + - $ref: '#/components/schemas/UsaCassVerifiedAddress' count: type: number description: | diff --git a/openapi.ts b/openapi.ts index d3357ff..46bd56f 100644 --- a/openapi.ts +++ b/openapi.ts @@ -1098,6 +1098,7 @@ export interface components { | "heresa" | "hereo" | "herena" + | "heremeas" | "heremea" | "herem" | "herei" @@ -1269,7 +1270,94 @@ export interface components { | "TTO" | "URY" | "VEN" - | "TWN"; + | "TWN" + | "CHN" + | "JPN" + | "KOR" + | "LAO" + | "MNG" + | "PNG" + | "PRK" + | "SLB" + | "TJK" + | "TKM" + | "BTN" + | "IOT" + | "LKA" + | "MDV" + | "NPL" + | "PAK" + | "AFG" + | "BDI" + | "BEN" + | "CAF" + | "CIV" + | "COD" + | "COG" + | "COM" + | "CPV" + | "DJI" + | "DZA" + | "ERI" + | "ESH" + | "ETH" + | "GAB" + | "GIN" + | "GMB" + | "GNB" + | "GNQ" + | "IRN" + | "IRQ" + | "LBR" + | "LBY" + | "MDG" + | "MLI" + | "MRT" + | "MWI" + | "NER" + | "RWA" + | "SHN" + | "SLE" + | "SOM" + | "SSD" + | "STP" + | "SYC" + | "TCD" + | "TGO" + | "TZA" + | "UGA" + | "SDN" + | "SYR" + | "YEM" + | "CUB" + | "SPM" + | "TCA" + | "COK" + | "KIR" + | "NIU" + | "NRU" + | "PCN" + | "TKL" + | "TUV" + | "WLF" + | "WSM" + | "AIA" + | "ATG" + | "BES" + | "FLK" + | "GRD" + | "KNA" + | "LCA" + | "MSR" + | "SGS" + | "SXM" + | "VCT" + | "ASM" + | "FSM" + | "MHL" + | "MNP" + | "PLW" + | "VIR"; /** * ISO Country Code (2) * @description 2 letter country code (ISO 3166-1) @@ -1435,7 +1523,93 @@ export interface components { | "TN" | "ZA" | "ZM" - | "ZW"; + | "ZW" + | "CN" + | "JP" + | "KR" + | "LA" + | "MN" + | "PG" + | "KP" + | "SB" + | "TJ" + | "TM" + | "BT" + | "IO" + | "LK" + | "MV" + | "NP" + | "PK" + | "AF" + | "BI" + | "BJ" + | "CF" + | "CI" + | "CD" + | "CG" + | "KM" + | "CV" + | "DJ" + | "DZ" + | "ER" + | "EH" + | "ET" + | "GA" + | "GN" + | "GM" + | "GW" + | "GQ" + | "IR" + | "IQ" + | "LR" + | "LY" + | "MG" + | "ML" + | "MR" + | "MW" + | "NE" + | "RW" + | "SH" + | "SL" + | "SO" + | "SS" + | "ST" + | "SC" + | "TD" + | "TG" + | "TZ" + | "UG" + | "SD" + | "SY" + | "YE" + | "CU" + | "PM" + | "TC" + | "CK" + | "KI" + | "NU" + | "NR" + | "PN" + | "TK" + | "TV" + | "WF" + | "WS" + | "AI" + | "AG" + | "BQ" + | "FK" + | "KN" + | "LC" + | "MS" + | "GS" + | "SX" + | "VC" + | "AS" + | "FM" + | "MH" + | "MP" + | "PW" + | "VI"; /** * Country * @description Full country names (ISO 3166) @@ -1605,7 +1779,94 @@ export interface components { | "Tunisia" | "South Africa" | "Zambia" - | "Zimbabwe"; + | "Zimbabwe" + | "China" + | "Japan" + | "South Korea" + | "Laos" + | "Mongolia" + | "Papua New Guinea" + | "North Korea" + | "Solomon Islands" + | "Tajikistan" + | "Turkmenistan" + | "Bhutan" + | "British Indian Ocean Territory" + | "Sri Lanka" + | "Maldives" + | "Nepal" + | "Pakistan" + | "Afghanistan" + | "Burundi" + | "Benin" + | "Central African Republic" + | "Côte d'Ivoire" + | "Democratic Republic of the Congo" + | "Republic of the Congo" + | "Comoros" + | "Cape Verde" + | "Djibouti" + | "Algeria" + | "Eritrea" + | "Western Sahara" + | "Ethiopia" + | "Gabon" + | "Guinea" + | "Gambia" + | "Guinea-Bissau" + | "Equatorial Guinea" + | "Iran" + | "Iraq" + | "Liberia" + | "Libya" + | "Madagascar" + | "Mali" + | "Mauritania" + | "Malawi" + | "Niger" + | "Rwanda" + | "Saint Helena" + | "Sierra Leone" + | "Somalia" + | "South Sudan" + | "São Tomé and Príncipe" + | "Seychelles" + | "Chad" + | "Togo" + | "Tanzania" + | "Uganda" + | "Sudan" + | "Syria" + | "Yemen" + | "Cuba" + | "Saint Pierre and Miquelon" + | "Turks and Caicos Islands" + | "Cook Islands" + | "Kiribati" + | "Niue" + | "Nauru" + | "Pitcairn Islands" + | "Tokelau" + | "Tuvalu" + | "Vanuatu" + | "Wallis and Futuna" + | "Samoa" + | "Anguilla" + | "Antigua and Barbuda" + | "Bonaire, Sint Eustatius and Saba" + | "Falkland Islands (Malvinas)" + | "Saint Kitts and Nevis" + | "Saint Lucia" + | "Montserrat" + | "South Georgia and the South Sandwich Islands" + | "Sint Maarten (Dutch part)" + | "Saint Vincent and the Grenadines" + | "American Samoa" + | "Federated States of Micronesia" + | "Marshall Islands" + | "Northern Mariana Islands" + | "Palau" + | "United States Virgin Islands"; EircBase: { id: components["schemas"]["ID"]; /** @description Source of address */ @@ -2033,21 +2294,48 @@ export interface components { * * @enum {string} */ - usps_country: "United States" | "Guam" | "Puerto Rico"; + usps_country: + | "American Samoa" + | "Federated States of Micronesia" + | "Guam" + | "Marshall Islands" + | "Northern Mariana Islands" + | "Palau" + | "Puerto Rico" + | "United States" + | "United States Virgin Islands"; /** * ISO Country Code (3) * @description 3 letter country code (ISO 3166-1) * * @enum {string} */ - usps_country_iso: "USA" | "PRI" | "GUM"; + usps_country_iso: + | "ASM" + | "FSM" + | "GUM" + | "MHL" + | "MNP" + | "PLW" + | "PRI" + | "USA" + | "VIR"; /** * ISO Country Code (2) * @description 2 letter country code (ISO 3166-1) * * @enum {string} */ - usps_country_iso_2: "US" | "PR" | "GU"; + usps_country_iso_2: + | "AS" + | "FM" + | "GU" + | "MH" + | "MP" + | "PR" + | "PW" + | "US" + | "VI"; /** * Language * @description Language represented by 2 letter ISO Code (639-1) @@ -2361,6 +2649,7 @@ export interface components { | "heresa" | "hereo" | "herena" + | "heremeas" | "heremea" | "herem" | "herei" @@ -2420,16 +2709,8 @@ export interface components { * @example 1 */ address_type?: string; - /** - * @description Latitude defining the arrival position of the Point Address. - * @example 45.28447 - */ - delivery_latitude: number; - /** - * @description Longitude defining the arrival position of the Point Address. - * @example 12.00821 - */ - delivery_longitude: number; + delivery_latitude: string | number; + delivery_longitude: string | number; /** * @description Name of the Building to which the Point Address is associated. * @@ -3120,7 +3401,7 @@ export interface components { * @description Australia Geocoded National Address File * @example true */ - gnaf?: boolean; + gnaf: boolean; /** * @description Asia Pacific Address File * @example true @@ -3146,6 +3427,11 @@ export interface components { * @example true */ heremea: boolean; + /** + * @description Middle East and Africa Standalone Intermediate Maps Address File + * @example true + */ + heremeas: boolean; /** * @description North America Address File * @example true @@ -3334,6 +3620,11 @@ export interface components { * @example true */ heremea?: boolean; + /** + * @description Middle East and Africa Extended File + * @example true + */ + heremeas?: boolean; /** * @description North America Address File * @example true @@ -3374,6 +3665,11 @@ export interface components { * @example true */ email?: boolean; + /** + * @description Australia Geoscape Geocoded National Address File + * @example true + */ + gnaf?: boolean; }; }; /** Key Usage */ @@ -3416,6 +3712,106 @@ export interface components { /** @enum {string} */ message: "Success"; }; + /** + * United States CASS Verified Address + * @description Address retrieved using CASS compliant address verification process + */ + UsaCassVerifiedAddress: { + /** @description Primary delivery address */ + address1: string; + /** @description Secondary address information */ + address2: string; + /** @description Additional secondary address information */ + address3: string; + /** @description Area code */ + area_code: string; + /** @description Data required to perform a Carrier Route sort */ + carrier_route: string; + /** @description Character following the 5- or 9-digit ZIP Code */ + check_digit: string; + /** @description City name */ + city: string; + /** @description City Abbreviation. Empty string if not present */ + city_abbreviation: string; + /** @description Identifies the Congressional District. Empty string if not present */ + congressional_district: string; + /** @description ISO3166 country code. Empty string if not present */ + country_code: string; + /** @description Name of the county */ + county: string; + /** @description Daylight saving time indicator */ + day_light_savings: string; + /** @description Last 2 digits of the primary street address number or Post Office™ box */ + delivery_point: string; + /** @description DPV Confirmation code. Possible values: 'Y' (Yes), 'S' (Suspicious), 'D' (No). */ + dpv: string; + /** @description DPV CMRA code. Possible values: 'Y' (Yes), 'N' (No). */ + dpv_cmra: string; + /** @description DPV Footnotes. Empty string if not present */ + dpv_footnotes: string; + /** @description False Positive Indicator from the DPV lookup. Possible values: 'Y' (Yes), 'N' (No), ' ' (Space). Empty string if not present */ + dpv_fp: string; + /** @description DPV NoStat code. Empty string if not present */ + dpv_no_stat: string; + /** @description DPV Vacant code. Empty string if not present */ + dpv_vacant: string; + /** @description Enhanced Line of Travel */ + elot: string; + /** @description Internal accounting number used by the USPS. Empty string if not present */ + finance_number: string | number; + /** @description Federal Information Processing Standard code for a county. Empty string if not present */ + fips_county_code: string; + /** @description Company name in a business address */ + firm: string; + /** @description Letter codes returned by ZIP + 4® encoding. Empty string if not present */ + footnotes: string; + /** @description Indicates whether the address was geo-coded. Possible values: 'Y' (Yes), 'N' (No). */ + geo_coded: string; + /** @description Indicates whether a record may benefit from LACS processing. Possible values: 'L' (Yes), ' ' (No). */ + lacs_indicator: string; + /** @description LACSLink Footnote. Empty string if not present */ + lacs_link_footnote: string; + /** @description LACSLink Indicator. Empty string if not present */ + lacs_link_indicator: string; + /** @description Latitude of the encoded address. Empty string if not present */ + latitude: string | number; + /** @description Longitude of the encoded address. Empty string if not present */ + longitude: string | number; + /** @description Information if a PMB is found in an address. Empty string if not present */ + parsed_pmb_designator: string; + /** @description Information if a PMB is found in an address. Empty string if not present */ + parsed_pmb_number: string | number; + /** @description Notation following the street name indicating street direction. Empty string if not present */ + parsed_post_directional: string | number; + /** @description Notation preceding the street name indicating street direction. Empty string if not present */ + parsed_pre_directional: string; + /** @description Number preceding the street name. Empty string if not present */ + parsed_primary_number: string | number; + /** @description Street name. Empty string if not present */ + parsed_street_name: string; + /** @description Part of the delivery address line following the street name. Empty string if not present */ + parsed_suffix: string; + /** @description Identification of the secondary address unit. Empty string if not present */ + parsed_unit_designator: string; + /** @description Apartment or suite number. Empty string if not present */ + parsed_unit_number: string; + /** @description Reserved for future use. Empty string if not present */ + rdi: string; + /** @description Type of address record (Street, PO Box, High-rise, etc.) */ + record_type: string; + /** @description Additional secondary address information. Empty string if not present */ + secondary_address_info: string; + /** @description Standard two-letter state abbreviation */ + state: string; + /** @description Results of the SuiteLink lookup. Possible values: ' ' (Space), '00' (Double Zero), 'A' (A). Empty string if not present */ + suite_link_footnote: string; + /** @description Time zone. Empty string if not present */ + time_zone: string; + /** @description Urban name required in the address of all mail being delivered to Puerto Rico. Empty string if not present */ + urbanization: string; + /** @description 5-digit ZIP Code™ and the four additional digits */ + zip_code: string; + }; /** Address Match */ GbrCleanseMatch: { /** @description Originally submitted query */ @@ -3426,7 +3822,8 @@ export interface components { | components["schemas"]["MrAddress"] | components["schemas"]["NybAddress"] | components["schemas"]["PafAliasAddress"] - | components["schemas"]["WelshPafAddress"]; + | components["schemas"]["WelshPafAddress"] + | components["schemas"]["UsaCassVerifiedAddress"]; /** @description The number of addresses we matched to the input. We return the closest match by default. */ count: number; /** @description A score represented as number between 1 and 0. Fit compares the address elements present in your query against the matching address elements. It does not incorporate elements you have not presented in the score. A partial address (e.g. 12 Pye Green Road) will have a fit of 1 even though it is missing post town and postcode. Its confidence score will be less than 1 however because it is missing some crucial elements. */ @@ -5310,6 +5707,32 @@ export interface operations { * @example 10 Downing Street, London, SW2A 2BN */ query: string; + /** + * @description Optionally specify postal code for the address. + * + * @example SW1A 2BN + */ + postcode?: string; + /** + * @description Optionally specify the city or town of the address. + * + * For UK verifications, this should be the "post town" of the address. + * + * For USA verifications, this should be the city of the address. + * + * @example London + */ + post_town?: string; + /** + * @description Optionally specify the county or state of the address. + * + * For UK verifications, we recommend omitting this field as county data is unreliable. + * + * For USA verifications, this should be the state of the address. + * + * @example Kent + */ + county?: string; }; }; }; diff --git a/package-lock.json b/package-lock.json index 7780b5b..c73b74c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@ideal-postcodes/openapi", - "version": "4.2.1", + "version": "4.3.0-beta.2", "lockfileVersion": 2, "requires": true, "packages": { "": { "name": "@ideal-postcodes/openapi", - "version": "4.2.1", + "version": "4.3.0-beta.1", "license": "MIT", "devDependencies": { "@cablanchard/semantic-release": "~1.3.4", diff --git a/package.json b/package.json index eb5a897..5479094 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@ideal-postcodes/openapi", "description": "Ideal Postcodes OpenAPI v3 specifications", - "version": "4.2.1", + "version": "4.3.0-beta.2", "devDependencies": { "@cablanchard/semantic-release": "~1.3.4", "@cablanchard/tsconfig": "~2.0.0",