> ## Documentation Index
> Fetch the complete documentation index at: https://www.illusory.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# New Zealand

> Residential targeting for New Zealand: states, regions, and cities with their targeting tokens.

Target New Zealand with `-country-nz` in your proxy username.

The full username form is `<username>-country-nz-state-<state>-city-<city>`.
Include the state to pin a specific city: many city names repeat across states, so
the state is what disambiguates them. Each state below lists its state-only token and
a table of cities with their combined state-plus-city tokens.

<Note>
  Available locations change frequently as the pool updates. State and city
  targeting resolve wherever the pool has coverage. If a location returns no exits,
  broaden to the country or retry later.
</Note>

## States and cities

<AccordionGroup>
  <Accordion title="Auckland (-state-auckland)">
    State-only token: `-state-auckland`

    | City           | Token                                |
    | -------------- | ------------------------------------ |
    | Auckland       | `-state-auckland-city-auckland`      |
    | Helensville    | `-state-auckland-city-helensville`   |
    | Newmarket      | `-state-auckland-city-newmarket`     |
    | Opaheke        | `-state-auckland-city-opaheke`       |
    | Pukekohe       | `-state-auckland-city-pukekohe`      |
    | Schnapper Rock | `-state-auckland-city-schnapperrock` |
  </Accordion>

  <Accordion title="Bay of Plenty (-state-bayofplenty)">
    State-only token: `-state-bayofplenty`

    | City            | Token                                    |
    | --------------- | ---------------------------------------- |
    | Greerton        | `-state-bayofplenty-city-greerton`       |
    | Mount Maunganui | `-state-bayofplenty-city-mountmaunganui` |
    | Rotorua         | `-state-bayofplenty-city-rotorua`        |
    | Tauranga        | `-state-bayofplenty-city-tauranga`       |
    | Te Puke         | `-state-bayofplenty-city-tepuke`         |
  </Accordion>

  <Accordion title="Canterbury (-state-canterbury)">
    State-only token: `-state-canterbury`

    | City         | Token                                 |
    | ------------ | ------------------------------------- |
    | Ashburton    | `-state-canterbury-city-ashburton`    |
    | Christchurch | `-state-canterbury-city-christchurch` |
    | New Brighton | `-state-canterbury-city-newbrighton`  |
    | Woodend      | `-state-canterbury-city-woodend`      |
  </Accordion>

  <Accordion title="Gisborne (-state-gisborne)">
    State-only token: `-state-gisborne`

    | City     | Token                           |
    | -------- | ------------------------------- |
    | Gisborne | `-state-gisborne-city-gisborne` |
  </Accordion>

  <Accordion title="Hawke's Bay Region (-state-hawkesbayregion)">
    State-only token: `-state-hawkesbayregion`

    | City        | Token                                    |
    | ----------- | ---------------------------------------- |
    | Napier City | `-state-hawkesbayregion-city-napiercity` |
  </Accordion>

  <Accordion title="Manawatu-Wanganui (-state-manawatuwanganui)">
    State-only token: `-state-manawatuwanganui`

    | City             | Token                                          |
    | ---------------- | ---------------------------------------------- |
    | Palmerston North | `-state-manawatuwanganui-city-palmerstonnorth` |
  </Accordion>

  <Accordion title="Nelson Region (-state-nelsonregion)">
    State-only token: `-state-nelsonregion`

    | City   | Token                             |
    | ------ | --------------------------------- |
    | Nelson | `-state-nelsonregion-city-nelson` |
  </Accordion>

  <Accordion title="Northland (-state-northland)">
    State-only token: `-state-northland`

    | City      | Token                             |
    | --------- | --------------------------------- |
    | Kerikeri  | `-state-northland-city-kerikeri`  |
    | Whangarei | `-state-northland-city-whangarei` |
  </Accordion>

  <Accordion title="Otago (-state-otago)">
    State-only token: `-state-otago`

    | City              | Token                               |
    | ----------------- | ----------------------------------- |
    | Arrowtown         | `-state-otago-city-arrowtown`       |
    | Brighton          | `-state-otago-city-brighton`        |
    | Dunedin           | `-state-otago-city-dunedin`         |
    | North East Valley | `-state-otago-city-northeastvalley` |
    | Port Chalmers     | `-state-otago-city-portchalmers`    |
  </Accordion>

  <Accordion title="Southland (-state-southland)">
    State-only token: `-state-southland`

    | City         | Token                                |
    | ------------ | ------------------------------------ |
    | Invercargill | `-state-southland-city-invercargill` |
  </Accordion>

  <Accordion title="Taranaki Region (-state-taranakiregion)">
    State-only token: `-state-taranakiregion`

    | City         | Token                                    |
    | ------------ | ---------------------------------------- |
    | New Plymouth | `-state-taranakiregion-city-newplymouth` |
  </Accordion>

  <Accordion title="Waikato Region (-state-waikatoregion)">
    State-only token: `-state-waikatoregion`

    | City        | Token                                   |
    | ----------- | --------------------------------------- |
    | Claudelands | `-state-waikatoregion-city-claudelands` |
    | Hamilton    | `-state-waikatoregion-city-hamilton`    |
    | Pokeno      | `-state-waikatoregion-city-pokeno`      |
    | Temple View | `-state-waikatoregion-city-templeview`  |
  </Accordion>

  <Accordion title="Wellington (-state-wellington)">
    State-only token: `-state-wellington`

    | City       | Token                               |
    | ---------- | ----------------------------------- |
    | Wellington | `-state-wellington-city-wellington` |
  </Accordion>

  <Accordion title="Wellington Region (-state-wellingtonregion)">
    State-only token: `-state-wellingtonregion`

    | City       | Token                                     |
    | ---------- | ----------------------------------------- |
    | Brooklyn   | `-state-wellingtonregion-city-brooklyn`   |
    | Lower Hutt | `-state-wellingtonregion-city-lowerhutt`  |
    | Masterton  | `-state-wellingtonregion-city-masterton`  |
    | Porirua    | `-state-wellingtonregion-city-porirua`    |
    | Upper Hutt | `-state-wellingtonregion-city-upperhutt`  |
    | Wellington | `-state-wellingtonregion-city-wellington` |
    | Wilton     | `-state-wellingtonregion-city-wilton`     |
  </Accordion>
</AccordionGroup>

## Networks (ASN)

Target a specific carrier or network with `-asn-<code>`. ASN selects by network operator, so combine it with a state or city to also pin a location. Mobile carriers cover a country nationwide; fixed and cable networks only have exits in their service areas, so pairing one with a city it does not serve falls back to another exit on that network.

<AccordionGroup>
  <Accordion title="All networks (31)">
    | Network                                   | Token         |
    | ----------------------------------------- | ------------- |
    | AS131296 REXNETWORKS LIMITED              | `-asn-131296` |
    | AS132815 Evolution Wireless Ltd           | `-asn-132815` |
    | AS136557 Host Universal Pty Ltd           | `-asn-136557` |
    | AS136787 PacketHub S.A.                   | `-asn-136787` |
    | AS137262 InTune Technologies Limited      | `-asn-137262` |
    | AS137409 GSL Networks Pty LTD             | `-asn-137409` |
    | AS139336 Freedom Internet Ltd.            | `-asn-139336` |
    | AS140680 NRG Automation Ltd               | `-asn-140680` |
    | AS16509 Amazon.com, Inc.                  | `-asn-16509`  |
    | AS17705 InSPire Net Ltd                   | `-asn-17705`  |
    | AS18199 Worldnet Services Limited         | `-asn-18199`  |
    | AS24398 Auckland University of Technology | `-asn-24398`  |
    | AS44559 IT HOSTLINE LTD                   | `-asn-44559`  |
    | AS45177 Devoli                            | `-asn-45177`  |
    | AS4768 One New Zealand Group Limited      | `-asn-4768`   |
    | AS56030 Voyager Internet Ltd.             | `-asn-56030`  |
    | AS58610 Telnet Telecommunication Limited  | `-asn-58610`  |
    | AS61138 Zappie Host                       | `-asn-61138`  |
    | AS9431 The University of Auckland         | `-asn-9431`   |
    | AS9500 One New Zealand Group Limited      | `-asn-9500`   |
    | AS9790 Two Degrees Networks Limited       | `-asn-9790`   |
    | FEENIX-AS-AP                              | `-asn-135069` |
    | MEDIATRIBELIMITED-AS-AP                   | `-asn-131198` |
    | MERCURYNZ-AS-AP                           | `-asn-55850`  |
    | NZWIRELESS-CO-NZ-AS-AP                    | `-asn-24111`  |
    | SKYTELEVISION-AS-AP                       | `-asn-140220` |
    | SPACEX-STARLINK                           | `-asn-14593`  |
    | SPARKNZ                                   | `-asn-4771`   |
    | TWODEGREES-NZ-AS                          | `-asn-23655`  |
    | UBB-AS-AP                                 | `-asn-133192` |
    | WIRELESSNATION-NZ                         | `-asn-132449` |
  </Accordion>
</AccordionGroup>