Find the US state of a site or charge point with the country subdivision code

Sites and charge points carry a country subdivision code, such as US-GA, that tells you which US state an address is in.

Updated 2 November 2026

This article is for operators who pull site and charge point addresses through the Partner API or in exports. It shows where to find the state of an address and how the value is set.

What the country subdivision code is

Every site and charge point has a country subdivision code. It follows the ISO 3166-2 standard and names the state, province or region of the address.

For a US address, the code is US- followed by the two-letter state code. For example, US-GA is Georgia.

Addresses on sites and charge points have no separate state field. Use the code instead.

Read the code in the Partner API

The Partner API returns the code as countrySubdivisionCode.

ResourceWhere to find the code
Sitelocation.address.countrySubdivisionCode
Charge pointlocation.address.countrySubdivisionCode
Account (team)address.countrySubdivisionCode

To get the state of a site:

  1. Retrieve the site with the Partner API.
  2. Read location.address.countrySubdivisionCode in the response.
  3. Split the value at the hyphen. The part after it is the state code, for example GA.

The value is null when Monta has no code for the address.

How the code is set

You do not enter the code yourself. Monta fills it in from the address location when you create or edit the address of a site or charge point.

A charge point added to a site gets the code of that site. If you give a charge point its own coordinates in the Partner API, Monta looks up the code for that point. If you move its pin in Hub, the code is cleared and the nightly backfill fills it in again for US charge points only.

For older addresses in the United States, Monta fills in the code with a nightly backfill. Older addresses in other countries stay empty until the address is saved again.

Use the code in exports

In Hub, open Analytics > Data exports and pick the Locations, EVSEs or Accounts dataset. The code is available as the column Country subdivision code. In the exported file, the column header is country_subdivision_code. For how to build and run an export, see How do I use Data exports in Hub?.

If the code is empty

If countrySubdivisionCode is null for a site or charge point:

  1. Check that the address on the site has a location Monta can resolve.
  2. Edit and save the address again. Monta then looks up the code.
  3. If the code is still empty, contact Monta support with the site or charge point ID.
Was this article helpful?