# List States

Get all your states.

Endpoint: POST /api/v1/state/search
Version: 1.0

## Request fields (application/json):

  - `condition` (object)
    Condition to filter results

  - `condition.field` (string)
    Field name to apply the condition to
    Example: "name"

  - `condition.value` (object)
    Value to compare against the field
    Example: "Example Value"

  - `condition.type` (string)
    Relational operator for the condition
    Enum: "BETWEEN", "EQ", "LT", "LTE", "GT", "GTE", "NE", "LIKE", "START", "FINISH", "IN", "NIN", "NLIKE", "LENGTH"

  - `condition.endValue` (object)
    End value for range conditions
    Example: 100

  - `condition.innerConditions` (array)
    Nested conditions for complex queries

  - `condition.conditionType` (string)
    Type of condition for combining multiple conditions
    Enum: "AND", "OR"

  - `condition.empty` (boolean)
    Indicates if the condition is empty

  - `condition.compareFields` (boolean)
    Indicates if comparing between fields

  - `sortCriteria` (array)
    List of sorting criteria to apply

  - `sortCriteria.sortField` (string)
    Field name to sort by
    Example: "name"

  - `sortCriteria.sortDirection` (string)
    Sort direction (ascending or descending)
    Enum: "ASC", "DESC"

  - `pageNumber` (integer, required)
    Page number to retrieve (0-based)

  - `pageSize` (integer, required)
    Number of items per page
    Example: 20

## Response 200 fields (application/json):

  - `data` (array, required)
    List of data items for the current page

  - `data.id` (integer, required)
    Unique identifier of the entity
    Example: 1

  - `data.code` (string, required)

  - `data.description` (string)

  - `data.country` (object)

  - `data.country.code` (string, required)
    Country code (usually ISO numeric or similar).
    Example: 724

  - `data.country.description` (string, required)
    Country description or name.
    Example: "Spain"

  - `data.country.isoCode` (string)
    ISO Alpha-2 code for the country.
    Enum: "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"

  - `data.country.customerVatType` (string)
    Type of VAT scheme for customers in this country.
    Example: "GENERAL"

  - `data.country.geographicalLocation` (string, required)
    Geographical location of the country. See ApiGeographicalLocation enum for values.
    Enum: "CEUTA_MELILLA_CANARIAS", "COMMUNITY", "NATIONAL", "OTHERS"

  - `data.isoCode` (string)

  - `page` (integer, required)
    Current page number (0-based)

  - `total` (integer, required)
    Total number of items across all pages
    Example: 150

  - `pages` (integer, required)
    Last page number (0-based)
    Example: 14

  - `size` (integer, required)
    Number of items per page
    Example: 10