---
title: "Get a list of subdivs by country with paging and filtering"
method: GET
path: "/country/{country_id}/subdiv"
tags: ["country"]
---

# Get a list of subdivs by country with paging and filtering

`GET /country/{country_id}/subdiv`

## Request

- Base URL: `https://submitapi.dvidshub.net`
- URL: `https://submitapi.dvidshub.net/country/{country_id}/subdiv`
- Auth: OAuth 2
  - Authorization code: `https://api.dvidshub.net/auth/authorize`
  - Token URL: `https://api.dvidshub.net/auth/access_token` scopes: `basic`, `email`, `upload`
- TypeScript: <https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/docs/country/:country_id/subdiv/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `name` string
- `page` integer
- `limit` integer

## Response `200`

An array of CountrySubdiv objects

- object
  - `links` object, required
    - `self` string, uri, required: URI of the current result set
    - `first` string, uri, required: URI of the first page of results
    - `last` string, uri, required: URI of the last page of results
    - `prev` string, uri, nullable: URI of the previous page of results (if any)
    - `next` string, uri, nullable: URI of the next page results (if any)
  - `data` object[], required
    - `id` string, required
    - `type` 'country-subdiv', required
    - `attributes` object, required
      - `name` string: The common or short-form name of this subdiv
      - `full_name` string: The long or official name of this subdiv
      - `type` 'State' | 'Province': The type of subdiv

---

[API](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api.md) - [All operations](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/revisions/921b385ab6b9?raw)