Get Region#
Description
Returns a single Region.
Request#
HTTP Method: GET
URI Path: /v3/regions/
URI Query Parameters:
Name |
Type |
Is Required? |
Description |
|---|---|---|---|
id |
|
Yes |
Unique ID identifier of the Region. |
include |
|
Optional |
Examples#
http
1GET /v3/regions/8ce33ee2-73da-4baa-85a0-cd607d0e9733 HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Api-Key: [API Token]
curl
1curl -i -X GET https://api.didww.com/v3/regions/8ce33ee2-73da-4baa-85a0-cd607d0e9733 -H "Accept: application/vnd.api+json" -H "Api-Key: [API Token]" -H "Content-Type: application/vnd.api+json"
response
1HTTP/1.1 200 OK
2Content-Type: application/vnd.api+json
3
4{
5 "data": {
6 "id": "8ce33ee2-73da-4baa-85a0-cd607d0e9733",
7 "type": "regions",
8 "attributes": {
9 "name": "Alberta",
10 "iso": "CA-AB"
11 },
12 "relationships": {
13 "country": {
14 "links": {
15 "self": "https://api.didww.com/v3/regions/8ce33ee2-73da-4baa-85a0-cd607d0e9733/relationships/country",
16 "related": "https://api.didww.com/v3/regions/8ce33ee2-73da-4baa-85a0-cd607d0e9733/country"
17 }
18 }
19 }
20 }
21}
http
1GET /v3/regions/e2f3f115-11f1-43cf-8279-08b29d94403d?include=country HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Api-Key: [API Token]
curl
1curl -i -X GET 'https://api.didww.com/v3/regions/e2f3f115-11f1-43cf-8279-08b29d94403d?include=country' -H "Accept: application/vnd.api+json" -H "Api-Key: [API Token]" -H "Content-Type: application/vnd.api+json"
response
1HTTP/1.1 200 OK
2Content-Type: application/vnd.api+json
3
4{
5 "data": {
6 "id": "8ce33ee2-73da-4baa-85a0-cd607d0e9733",
7 "type": "regions",
8 "attributes": {
9 "name": "Alberta",
10 "iso": "CA-AB"
11 },
12 "relationships": {
13 "country": {
14 "links": {
15 "self": "https://api.didww.com/v3/regions/8ce33ee2-73da-4baa-85a0-cd607d0e9733/relationships/country",
16 "related": "https://api.didww.com/v3/regions/8ce33ee2-73da-4baa-85a0-cd607d0e9733/country"
17 }
18 }
19 }
20 },
21 "included": [
22 {
23 "id": "fa914558-9c64-4e01-967b-3302bd65a97b",
24 "type": "countries",
25 "attributes": {
26 "name": "Canada",
27 "prefix": "1",
28 "iso": "CA"
29 }
30 }
31 ]
32}
Other Responses#
Code |
Success |
Description |
|---|---|---|
404 |
No |
|
401 |
No |