# Retrieve the state cost for a product in a given state

Endpoint: GET /v1/{countryCode}/products/{productNumber}/state-costs/{stateCode}
Version: 0.0.1
Security: jwt-authorizer

## Path parameters:

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

  - `productNumber` (string, required)

  - `stateCode` (string, required)

## Response 200 fields (application/json):

  - `productNumber` (string, required)
    The unique product number identifier.
    Example: "3000650"

  - `stateCode` (string, required)
    The two-character state code the cost applies to.
    Example: "02"

  - `fullyRebatedCost` (number, required)
    The fully rebated cost of the product in the given state.
    Example: 356.51

  - `invoiceCost` (number)
    The invoice cost of the product in the given state.
    Example: 356.51

  - `rebateCode` (string)
    Code identifying the applicable rebate.
    Example: "1"

  - `serialNumber` (integer)
    Unique serial number associated with the state cost record.
    Example: 501627594

  - `supplierNumber` (string)
    Identifier of the supplier for this product in the state.
    Example: "27381"

## Response 400 fields (application/json):

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

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

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

  - `timestamp` (string)
    Time the error occurred, in ISO 8601 format.
    Example: "2026-06-03T10:15:30Z"

  - `details` (array, required)
    Structured additional information, such as per-field validation errors.

  - `details.field` (string)
    The request field the issue relates to.
    Example: "stateCode"

  - `details.issue` (string)
    Description of the problem with the field.
    Example: "Must be a two-digit state code."

## Response 401 fields (application/json):

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

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

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

  - `timestamp` (string)
    Time the error occurred, in ISO 8601 format.
    Example: "2026-06-03T10:15:30Z"

  - `details` (array)
    Structured additional information, such as per-field validation errors.