---
title: "Get Company States"
method: GET
path: "/company-settings/location-settings/countries/{countryId}/states"
tags: ["company"]
---

# Get Company States

`GET /company-settings/location-settings/countries/{countryId}/states`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/company-settings/location-settings/countries/{countryId}/states`
- Auth: HTTP bearer

Use this endpoint to get a list of the states supported by the current company. CountryId must be an existing country supported by the current company. This endpoint will return a paginated response starting from the given record index. StartIndex starts at 0. Default PageSize is 100. Pagination parameters are optional.

## Path parameters

- `countryId` string, integer, required

## Query parameters

- `pageSize` integer
- `recordStartIndex` integer

## Response `200`

OK

- CompanyStatesCollection
  - `count` integer: The total number of items matching the current query.
  - `pageSize` integer: The requested or default page size.
  - `pageStartIndex` integer: The requested or default index of the first element to return.
  - `items` State[]
    - `id` integer: The id for the state.
    - `name` string: The name of the State.
    - `abbreviation` string: The 2 character abbreviation for the State.
    - `_link` string: The URI of the State.

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `416`: Range Not Satisfiable.

## Changes

- **2026-11-03** `443924b00f43`: 5 breaking, 2 warning, 2 info
  - for the `query` request parameter `pageSize`, default value `25` was removed
  - the `allOf[subschema #2]/items/items/_link` response's property format changed from `uri` to no format for status `200`
  - removed the required property `status` from the response with the `416` status
  - removed the required property `title` from the response with the `416` status
  - …5 more

[Operation history](https://skmtc.dev/acculynx/apis/acculynx-api-v2/changes/company-settings/location-settings/countries/:countryId/states/get.md)

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)