# Get a state by code

Endpoint: GET /v1/{countryCode}/states/{code}
Version: 0.0.1
Security: jwt-authorizer

## Path parameters:

  - `countryCode` (string, required)
    Enum: "au", "nz"

  - `code` (string, required)
    The state or territory code (e.g. VIC, NSW, QLD).

## Response 200 fields (application/json):

  - `id` (integer, required)
    Unique numeric identifier for the state.
    Example: 258

  - `code` (string, required)
    Numeric code identifying the state or territory.
    Example: "03"

  - `description` (string, required)
    Full name of the state or territory.
    Example: "Victoria"

  - `shortDescription` (string)
    Abbreviated name of the state or territory.
    Example: "VIC"

  - `adminStateCode` (string)
    Administrative state code used for internal classification. May differ from the primary code.
    Example: "03"

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Stable machine-readable error identifier (UPPERCASE_WITH_UNDERSCORES).
    Example: "RESOURCE_NOT_FOUND"

  - `message` (string, required)
    Human-readable error description.
    Example: "The requested resource was not found."

  - `timestamp` (string)
    Time at which the error occurred (ISO 8601).
    Example: "2026-06-04T10:15:30Z"

  - `status` (integer)
    HTTP status code.
    Example: 404

  - `instance` (string)
    The request path or resource identifier that triggered the error.
    Example: "/v1/au/branches/MEL01"

  - `details` (array, required)
    Structured validation error details (populated for 400 responses).

  - `details.field` (string)
    The field that failed validation.
    Example: "typeCodes"

  - `details.issue` (string)
    Description of the validation failure.
    Example: "Invalid branch type code value."

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Stable machine-readable error identifier (UPPERCASE_WITH_UNDERSCORES).
    Example: "RESOURCE_NOT_FOUND"

  - `message` (string, required)
    Human-readable error description.
    Example: "The requested resource was not found."

  - `timestamp` (string)
    Time at which the error occurred (ISO 8601).
    Example: "2026-06-04T10:15:30Z"

  - `status` (integer)
    HTTP status code.
    Example: 404

  - `instance` (string)
    The request path or resource identifier that triggered the error.
    Example: "/v1/au/branches/MEL01"

  - `details` (array)
    Structured validation error details (populated for 400 responses).