Tools

Additional Resources

Working with Country Codes

Introduction

The Procore API includes a number of endpoints that provide country_code and state_code
parameters used to represent geographic location information. It is important to note that these parameters expect values that adhere to the
Alpha-2 variant of the ISO-3166 specification. ISO-3166 Alpha-2
designates a unique upper-case, two-character code for each country. For example, the ISO-3166 Alpha-2 code for the United States is 'US'. Similarly, codes
designating country subdivisions (e.g., states, provinces, etc.) also follow the upper-case, two-character scheme. For example, the
ISO-3166 Alpha-2 code for California is 'CA'.

If you intend to utilize any of the Procore API endpoints that include the country_code and/or
state_code parameters, the values you pass must adhere to the ISO-3166 standard described above. Rather than
creating and maintaining your own lookup table of code values, we recommend leveraging one of the many available country code libraries
for your particular coding language and platform.

Endpoints with country_code and state_code Parameters

Here are the Procore API endpoints that include country_code and state_code parameters: