Skip to main content

Apple Business guidance for capturing a location's address

Overview​

Use this resource to determine address rules for each supported country. An explicit set of rules is only provided for a structuredAddress.

Always Required​

  • mainAddress.structuredAddress.countryCode

Always Optional​

  • mainAddress.structuredAddress.unit
  • mainAddress.structuredAddress.floor
  • mainAddress.structuredAddress.building
  • mainAddress.structuredAddress.dependentLocality

Conditionally Required​

Address components which are optional for all countries except where required (✓).

  • mainAddress.structuredAddress.fullThoroughfare
  • mainAddress.structuredAddress.locality
  • mainAddress.structuredAddress.subLocality
  • mainAddress.structuredAddress.administrativeArea
  • mainAddress.structuredAddress.subAdministrativeArea
  • mainAddress.structuredAddress.postCode

Legend

LabelName
FTfullThoroughfare
Loclocality
SubLocsubLocality
AdmAadministrativeArea
SubAdmAsubAdministrativeArea
PCpostCode
CodeFTLocSubLocAdmASubAdmAPC
AD
REQUIRED
REQUIRED
AE
REQUIRED
REQUIRED
AF
REQUIRED
REQUIRED
AG
REQUIRED
REQUIRED
AI
REQUIRED
REQUIRED
AL
REQUIRED
REQUIRED
AM
REQUIRED
REQUIRED
AO
REQUIRED
REQUIRED
AQ
REQUIRED
REQUIRED
AR
REQUIRED
REQUIRED
AS
REQUIRED
REQUIRED
REQUIRED
REQUIRED
AT
REQUIRED
REQUIRED
REQUIRED
AU
REQUIRED
REQUIRED
REQUIRED
REQUIRED
AW
REQUIRED
REQUIRED
AX
REQUIRED
REQUIRED
AZ
REQUIRED
REQUIRED
BA
REQUIRED
REQUIRED
REQUIRED
BB
REQUIRED
REQUIRED
BD
REQUIRED
REQUIRED
BE
REQUIRED
REQUIRED
REQUIRED
REQUIRED
BF
REQUIRED
REQUIRED
BG
REQUIRED
REQUIRED
BH
REQUIRED
REQUIRED
BI
REQUIRED
REQUIRED
BJ
REQUIRED
REQUIRED
BL
REQUIRED
REQUIRED
BM
REQUIRED
REQUIRED
BN
REQUIRED
REQUIRED
BO
REQUIRED
REQUIRED
BQ
REQUIRED
REQUIRED
BR
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
BS
REQUIRED
REQUIRED
BT
REQUIRED
REQUIRED
BV
REQUIRED
REQUIRED
BW
REQUIRED
REQUIRED
BZ
REQUIRED
REQUIRED
CA
REQUIRED
REQUIRED
REQUIRED
REQUIRED
CC
REQUIRED
REQUIRED
CD
REQUIRED
REQUIRED
CF
REQUIRED
REQUIRED
CG
REQUIRED
REQUIRED
CH
REQUIRED
REQUIRED
REQUIRED
CI
REQUIRED
REQUIRED
CK
REQUIRED
REQUIRED
CL
REQUIRED
REQUIRED
CM
REQUIRED
REQUIRED
CN
REQUIRED
REQUIRED
CO
REQUIRED
REQUIRED
CR
REQUIRED
REQUIRED
CV
REQUIRED
REQUIRED
CW
REQUIRED
REQUIRED
CX
REQUIRED
REQUIRED
CY
REQUIRED
REQUIRED
CZ
REQUIRED
REQUIRED
DE
REQUIRED
REQUIRED
REQUIRED
DJ
REQUIRED
REQUIRED
DK
REQUIRED
REQUIRED
REQUIRED
DM
REQUIRED
REQUIRED
DO
REQUIRED
REQUIRED
DZ
REQUIRED
REQUIRED
EC
REQUIRED
REQUIRED
EE
REQUIRED
REQUIRED
EG
REQUIRED
EH
REQUIRED
REQUIRED
ER
REQUIRED
REQUIRED
ES
REQUIRED
REQUIRED
REQUIRED
ET
REQUIRED
REQUIRED
FI
REQUIRED
REQUIRED
REQUIRED
FJ
REQUIRED
REQUIRED
FK
REQUIRED
REQUIRED
FM
REQUIRED
REQUIRED
FO
REQUIRED
REQUIRED
FR
REQUIRED
REQUIRED
REQUIRED
GA
REQUIRED
REQUIRED
GB
REQUIRED
REQUIRED
REQUIRED
GD
REQUIRED
REQUIRED
GE
REQUIRED
REQUIRED
GF
REQUIRED
REQUIRED
GH
REQUIRED
REQUIRED
GI
REQUIRED
REQUIRED
GL
REQUIRED
REQUIRED
GM
REQUIRED
REQUIRED
GN
REQUIRED
REQUIRED
GP
REQUIRED
REQUIRED
GQ
REQUIRED
REQUIRED
GR
REQUIRED
REQUIRED
REQUIRED
GS
REQUIRED
REQUIRED
GT
REQUIRED
REQUIRED
GW
REQUIRED
REQUIRED
GY
REQUIRED
REQUIRED
HK
REQUIRED
REQUIRED
REQUIRED
HM
REQUIRED
REQUIRED
HN
REQUIRED
REQUIRED
HR
REQUIRED
REQUIRED
HT
REQUIRED
REQUIRED
HU
REQUIRED
REQUIRED
REQUIRED
ID
REQUIRED
REQUIRED
REQUIRED
REQUIRED
IE
REQUIRED
REQUIRED
REQUIRED
IL
REQUIRED
REQUIRED
IN
REQUIRED
REQUIRED
REQUIRED
REQUIRED
IO
REQUIRED
REQUIRED
IQ
REQUIRED
REQUIRED
IS
REQUIRED
REQUIRED
IT
REQUIRED
REQUIRED
REQUIRED
REQUIRED
JM
REQUIRED
REQUIRED
JO
REQUIRED
REQUIRED
JP
REQUIRED
REQUIRED
REQUIRED
REQUIRED
KE
REQUIRED
REQUIRED
KG
REQUIRED
REQUIRED
KH
REQUIRED
REQUIRED
KI
REQUIRED
REQUIRED
KM
REQUIRED
REQUIRED
KN
REQUIRED
REQUIRED
KW
REQUIRED
REQUIRED
KY
REQUIRED
REQUIRED
KZ
REQUIRED
REQUIRED
LA
REQUIRED
REQUIRED
LB
REQUIRED
REQUIRED
LC
REQUIRED
REQUIRED
LI
REQUIRED
REQUIRED
LK
REQUIRED
REQUIRED
LR
REQUIRED
REQUIRED
LS
REQUIRED
REQUIRED
LT
REQUIRED
REQUIRED
LU
REQUIRED
REQUIRED
LV
REQUIRED
REQUIRED
LY
REQUIRED
REQUIRED
MA
REQUIRED
REQUIRED
MC
REQUIRED
REQUIRED
MD
REQUIRED
REQUIRED
ME
REQUIRED
REQUIRED
MF
REQUIRED
REQUIRED
MG
REQUIRED
REQUIRED
MH
REQUIRED
REQUIRED
MK
REQUIRED
REQUIRED
ML
REQUIRED
REQUIRED
MM
REQUIRED
REQUIRED
MN
REQUIRED
REQUIRED
MO
REQUIRED
REQUIRED
MP
REQUIRED
REQUIRED
REQUIRED
REQUIRED
MQ
REQUIRED
REQUIRED
MR
REQUIRED
REQUIRED
MS
REQUIRED
REQUIRED
MT
REQUIRED
REQUIRED
MU
REQUIRED
REQUIRED
MV
REQUIRED
REQUIRED
MW
REQUIRED
REQUIRED
MX
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
MY
REQUIRED
REQUIRED
REQUIRED
MZ
REQUIRED
REQUIRED
NA
REQUIRED
REQUIRED
NC
REQUIRED
REQUIRED
NE
REQUIRED
REQUIRED
NF
REQUIRED
REQUIRED
NG
REQUIRED
REQUIRED
NI
REQUIRED
REQUIRED
NL
REQUIRED
REQUIRED
REQUIRED
NO
REQUIRED
REQUIRED
REQUIRED
NP
REQUIRED
REQUIRED
NR
REQUIRED
REQUIRED
NU
REQUIRED
REQUIRED
NZ
REQUIRED
REQUIRED
REQUIRED
OM
REQUIRED
REQUIRED
PA
REQUIRED
REQUIRED
PE
REQUIRED
REQUIRED
PF
REQUIRED
REQUIRED
PG
REQUIRED
REQUIRED
PH
REQUIRED
REQUIRED
PK
REQUIRED
REQUIRED
PL
REQUIRED
REQUIRED
REQUIRED
PM
REQUIRED
REQUIRED
PN
REQUIRED
REQUIRED
PS
REQUIRED
REQUIRED
PT
REQUIRED
REQUIRED
REQUIRED
PW
REQUIRED
REQUIRED
PY
REQUIRED
REQUIRED
QA
REQUIRED
REQUIRED
RE
REQUIRED
REQUIRED
RO
REQUIRED
REQUIRED
RS
REQUIRED
REQUIRED
REQUIRED
REQUIRED
RW
REQUIRED
REQUIRED
SA
REQUIRED
REQUIRED
SB
REQUIRED
REQUIRED
SC
REQUIRED
REQUIRED
SD
REQUIRED
REQUIRED
SE
REQUIRED
REQUIRED
REQUIRED
SG
REQUIRED
REQUIRED
SH
REQUIRED
REQUIRED
SI
REQUIRED
REQUIRED
SJ
REQUIRED
REQUIRED
SK
REQUIRED
REQUIRED
SL
REQUIRED
REQUIRED
SM
REQUIRED
REQUIRED
SN
REQUIRED
REQUIRED
SO
REQUIRED
REQUIRED
SR
REQUIRED
REQUIRED
SS
REQUIRED
REQUIRED
ST
REQUIRED
REQUIRED
SV
REQUIRED
REQUIRED
SX
REQUIRED
REQUIRED
SZ
REQUIRED
REQUIRED
TC
REQUIRED
REQUIRED
TD
REQUIRED
REQUIRED
TF
REQUIRED
REQUIRED
TG
REQUIRED
REQUIRED
TH
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
TJ
REQUIRED
REQUIRED
TK
REQUIRED
REQUIRED
TL
REQUIRED
REQUIRED
TM
REQUIRED
REQUIRED
TN
REQUIRED
REQUIRED
TO
REQUIRED
REQUIRED
TR
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
TT
REQUIRED
REQUIRED
TV
REQUIRED
REQUIRED
TW
REQUIRED
REQUIRED
REQUIRED
TZ
REQUIRED
REQUIRED
UG
REQUIRED
REQUIRED
UM
REQUIRED
REQUIRED
REQUIRED
REQUIRED
US
REQUIRED
REQUIRED
REQUIRED
REQUIRED
UY
REQUIRED
REQUIRED
UZ
REQUIRED
REQUIRED
VA
REQUIRED
REQUIRED
VC
REQUIRED
REQUIRED
VE
REQUIRED
REQUIRED
VG
REQUIRED
REQUIRED
VN
REQUIRED
REQUIRED
REQUIRED
REQUIRED
VU
REQUIRED
REQUIRED
WF
REQUIRED
REQUIRED
WS
REQUIRED
REQUIRED
YE
REQUIRED
REQUIRED
YT
REQUIRED
REQUIRED
ZA
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
ZM
REQUIRED
REQUIRED
ZW
REQUIRED
REQUIRED
NameReference
Unsupported RegionsLink
Unsupported ISO 3166-1 alpha-2 codesLink
Copyright © 2026 Apple Inc. All rights reserved.