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:

• Company Users [Create, Sync, Update]
• Company Offices [Create, Update]
• Company Vendors [Create, Sync, Update]
• Projects [Create, Sync, Update]
• Project Users [Create, Update]
• Project Vendors [Create, Update]