GET /services/platforms/v1/geo/countries/{iso2}/states Public

List States

Parameters

Name	Type	In	Required	Description
`iso2`	string	path	Required	Country ISO2 code (e.g. US, NL, DE) Example: `US`

Responses

200

422

429

List of states/provinces for the given country

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string
`data`	string

Validation error

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string
`data`	mixed[]

Too Many Requests — rate limit exceeded

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`
`Retry-After`	integer	Seconds until the rate limit resets	`60`

Field	Type	Description
`error`	boolean
`message`	string

Base URL

https://api.wemasy.nl/api

Authentication

Request Sample

cURL

PHP

Python

curl -X GET "https://api.wemasy.nl/api/services/platforms/v1/geo/countries/{iso2}/states" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

fetch('https://api.wemasy.nl/api/services/platforms/v1/geo/countries/{iso2}/states', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Accept': 'application/json'  }})
.then(r => r.json())
.then(data => console.log(data));

$response = Http::withToken('YOUR_API_TOKEN')
    ->accept('application/json')
    ->get('https://api.wemasy.nl/api/services/platforms/v1/geo/countries/{iso2}/states');
$data = $response->json();

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
r = requests.get("https://api.wemasy.nl/api/services/platforms/v1/geo/countries/{iso2}/states", headers=headers)
print(r.json())

Response Example

{
    "error": false,
    "message": "Success",
    "data": [
        {
            "iso2": "CA",
            "name": "California"
        },
        {
            "iso2": "NY",
            "name": "New York"
        },
        {
            "iso2": "TX",
            "name": "Texas"
        }
    ]
}

Try It

iso2 Required

Export