Get Address#

Returns a single Address in the account.

Request#

HTTP Method: GET

URI Path: /v3/addresses/

Note

For all returned data attributes, see Address Object.

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique ID identifier of the Addresses.

include

string

No

Inclusion.

Includes#

Value

Description

country

Country Object

proofs

Proofs Object

proofs.proof_type

Proof Types Object

identity

Identities Object

identity.country

Country Object

identity.proofs

Proofs Object

identity.proofs.proof_type

Proofs Object

identity.permanent_documents

Permanent Documents Object

identity.permanent_documents.template

Supporting Document Template Object

area

Area Object

city

City Object

Examples#

http

1GET /v3/addresses/0083c7f2-b030-491f-91b3-54597967ca38 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/addresses/0083c7f2-b030-491f-91b3-54597967ca38 -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": "54c92d8e-f135-4b55-ac48-748d44437509",
 7        "type": "addresses",
 8        "attributes": {
 9            "city_name": "Dublin",
10            "postal_code": "Dublin 8",
11            "address": "10/13 Thomas Street",
12            "description": "My Business Address",
13            "created_at": "2020-09-14T07:29:41.413Z",
14            "verified": false,
15            "external_reference_id": null
16        },
17        "relationships": {
18            "identity": {
19                "links": {
20                    "self": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/relationships/identity",
21                    "related": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/identity"
22                }
23            },
24            "country": {
25                "links": {
26                    "self": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/relationships/country",
27                    "related": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/country"
28                }
29            },
30            "proofs": {
31                "links": {
32                    "self": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/relationships/proofs",
33                    "related": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/proofs"
34                }
35            },
36            "area": {
37              "links": {
38                "self": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/relationships/area",
39                "related": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/area"
40              }
41            },
42            "city": {
43              "links": {
44                "self": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/relationships/city",
45                "related": "https://sandbox-api.didww.com/v3/addresses/54c92d8e-f135-4b55-ac48-748d44437509/city"
46              }
47            }
48        }
49    },
50    "meta": {
51        "api_version": "2026-04-16"
52    }
53}

Other Responses#

Code

Success

Description

404

No

Not Found

401

No

Unauthorized