---
title: "Reference"
description: "Country reference data — the ISO 3166 lists the address contract validates against."
canonical_url: "https://twominutebilling.com/help/developers/api-reference/reference"
---
# Reference

> Country reference data — the ISO 3166 lists the address contract validates against.

Country reference data — the ISO 3166 lists the address contract validates against. UNAUTHENTICATED, because hosted checkout and the customer portal render the same address form under a short-lived buyer token rather than an org API key. Cacheable for a day.

## Endpoints

<table>
<thead>
  <tr>
    <th>
      Method
    </th>
    
    <th>
      Endpoint
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/reference/list-every-country">
        <code>
          /v1/countries
        </code>
      </a>
    </td>
    
    <td>
      List every country
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/reference/get-one-country-by-iso-3166-1-alpha-2-code">
        <code>
          /v1/countries/{code}
        </code>
      </a>
    </td>
    
    <td>
      Get one country by ISO 3166-1 alpha-2 code
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/reference/list-a-country-s-subdivisions">
        <code>
          /v1/countries/{code}/subdivisions
        </code>
      </a>
    </td>
    
    <td>
      List a country’s subdivisions
    </td>
  </tr>
</tbody>
</table>


## Sitemap

See the full [sitemap](https://twominutebilling.com/sitemap.md) for all pages.