Get Single Country
Retrieve detailed information for a specific country including all its states/provinces.
Endpoint
GET /api/shop/countries/{id}Request Headers
| Header | Required | Description |
|---|---|---|
Content-Type | Yes | application/json |
X-STOREFRONT-KEY | Yes | Your storefront API key |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Country ID |
Response Fields (200 OK)
| Field | Type | Description |
|---|---|---|
id | integer | Country ID |
code | string | ISO 2-letter country code |
name | string | Country name |
createdAt | string | Creation date |
states | array | States/provinces within country |
State Fields
| Field | Type | Description |
|---|---|---|
id | integer | State ID |
code | string | State/province code |
name | string | State/province name |
Use Cases
- Load states/provinces for selected country
- Display country information
- Validate shipping addresses
- Populate address forms with state options