State codes

Understanding supported state and province codes is essential for order fulfillment and address validation.

Overview

The API supports fulfillment to most US states and Canadian provinces. Use the standard two-letter state/province codes when submitting addresses for orders and shipments.

Supported regions

United States

The following US state codes are supported for fulfillment:

AL, AK, AS, AZ, AR, CA, CO, CT, DE, DC, FM, FL, GA, GU, HI, ID, IL, IN, IA, KS, KY, LA, ME, MH, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, MP, OH, OK, OR, PW, PA, PR, RI, SC, SD, TN, TX, UT, VT, VI, VA, WA, WV, WI, WY

Canada

The following Canadian province codes are supported:

AB, BC, MB, NB, NL, NT, NS, NU, ON, PE, QC, SK, YT

Province reference:

Usage in API requests

When creating orders or managing addresses, use the two-letter state/province code:

const baseUrl = 'https://api.hlc.bike/us/v4.1'
const apiKey = process.env.HLC_API_KEY

const res = await fetch(`${baseUrl}/Orders/Create/FulFillment`, {
  method: 'POST',
  headers: {
    Authorization: apiKey,
    language: 'en',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    items: [{ variantNo: '020056-07', quantity: 2 }],
    shippingAddress: {
      name: 'John Doe',
      address1: '123 Main St',
      city: 'Springfield',
      state: 'IL', // Two-letter state code
      zip: '62701',
      country: 'US',
    },
  }),
})

const order = await res.json()

Validation

The API validates state codes during order creation. If an invalid or unsupported state code is provided, the request will return an error. Always verify that the state code matches the country code in your address data.