---
title: "List State records"
method: GET
path: "/resource/State"
tags: ["State"]
---

# List State records

`GET /resource/State`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api/v1`
- URL: `https://your-subdomain.deputy.deputy.com/api/v1/resource/State`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://once.deputy.com/my/oauth/login`
    - Token URL: `https://once.deputy.com/my/oauth/access_token`

Returns State records the authenticated caller is permitted to see. For large tables prefer POST /QUERY with pagination.

## Response `200`

Success

- State[]
  - `Id` integer, required
  - `Country` integer, required
  - `Code` string, required
  - `Active` boolean, required
  - `SortOrder` integer
  - `State` string, required
  - `Creator` integer, required
  - `Created` string, date-time, required
  - `Modified` string, required
  - `CountryObject` object

## Other responses

- `400`: Bad request
- `401`: Authentication required or invalid token
- `403`: Forbidden — token lacks access to this resource
- `404`: Resource not found

---

[API](https://skmtc.dev/deputy/apis/deputy-v1-resource-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v1-resource-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v1-resource-api/revisions/5d8e44000786?raw)
