Get Address Requirements

Returns the list of address requirements.

Request

HTTP Method: GET

URI Path: /v3/address_requirements

Note

For all returned data attributes, see Address Requirement Object.

URI Query Parameters

Name	Type	Is Required?	Description
include	string	No	Inclusion
filter[<filter_name>]	string	No	Filtering
fields[address_requirements]	string	No	Sparse fieldsets
sort	string	No	Sorting

Includes

Value	Description
country	Country Object
did_group_type	DID Group Type Object
personal_permanent_document	Supporting Document Template Object
business_permanent_document	Supporting Document Template Object
personal_onetime_document	Supporting Document Template Object
business_onetime_document	Supporting Document Template Object
personal_proof_types	Proof Type Object
business_proof_types	Proof Type Object
address_proof_types	Proof Type Object

Filters

Filter Name	Type	Allow Blank	Allow Array	Filters by:
id	string	No	Yes	Address requirement id field.
country.id	string	Yes	Yes	The country.id field.
did_group_type.id	string	Yes	Yes	The did_group_type.id field.

Available Mandatory Fields

Important

The personal_mandatory_fields and business_mandatory_fields arrays in the response may contain a selection of the fields listed below, depending on the specific requirement.

PersonalBusiness

Value	Description
birth_date	The user’s date of birth.
country	The user’s country of tax residence.
birth_country	The user’s country of birth.
id_number	The user’s national identification number.
personal_tax_id	The user’s personal tax identification number.
contact_email	The user’s contact email address.

Example

Simple RequestFilter by country.id (i.e. Germany)Filter by did_group_type.id (i.e. Shared-Cost)Include country while filtered by did_group_type.id

http

GET /v3/address_requirements HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

curl

curl -i -X GET https://api.didww.com/v3/address_requirements -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"

response

HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
    "data": [
        {
            "id": "3f3be6a6-a513-4509-bd9b-945e599e16f5",
            "type": "address_requirements",
            "attributes": {
                "identity_type": "any",
                "personal_area_level": "world_wide",
                "business_area_level": "world_wide",
                "address_area_level": "area",
                "personal_proof_qty": 0,
                "business_proof_qty": 0,
                "address_proof_qty": 0,
                "personal_mandatory_fields": null,
                "business_mandatory_fields": null,
                "service_description_required": true,
                "restriction_message": "Restriction message"
            },
            "relationships": {
                "country": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/country",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/country"
                    }
                },
                "did_group_type": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/did_group_type",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/did_group_type"
                    }
                },
                "personal_permanent_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/personal_permanent_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/personal_permanent_document"
                    }
                },
                "business_permanent_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/business_permanent_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/business_permanent_document"
                    }
                },
                "personal_onetime_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/personal_onetime_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/personal_onetime_document"
                    }
                },
                "business_onetime_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/business_onetime_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/business_onetime_document"
                    }
                },
                "personal_proof_types": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/personal_proof_types",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/personal_proof_types"
                    }
                },
                "business_proof_types": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/business_proof_types",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/business_proof_types"
                    }
                },
                "address_proof_types": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/address_proof_types",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/address_proof_types"
                    }
                }
            }
        },
        {
            "id": "d210e6e4-1716-4342-b04c-7a6ef6feb171",
            "type": "address_requirements",
            "attributes": {
                "identity_type": "business",
                "personal_area_level": null,
                "business_area_level": "world_wide",
                "address_area_level": "area",
                "personal_proof_qty": 0,
                "business_proof_qty": 1,
                "address_proof_qty": 1,
                "personal_mandatory_fields": null,
                "business_mandatory_fields": null,
                "service_description_required": true,
                "restriction_message": "Ireland Local DID registration requirements:\r\n\r\n1. Name, business name and contact phone number.\r\n2. Current address in Ireland, must be from the same area in Ireland as DID ordered (street, building number, postal code, city).\r\n\r\nDID number will not be activated until full registration details are provided and approved."
            },
            "relationships": {
                "country": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
                    }
                },
                "did_group_type": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type"
                    }
                },
                "personal_permanent_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/personal_permanent_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/personal_permanent_document"
                    }
                },
                "business_permanent_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/business_permanent_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/business_permanent_document"
                    }
                },
                "personal_onetime_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/personal_onetime_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/personal_onetime_document"
                    }
                },
                "business_onetime_document": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/business_onetime_document",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/business_onetime_document"
                    }
                },
                "personal_proof_types": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/personal_proof_types",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/personal_proof_types"
                    }
                },
                "business_proof_types": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/business_proof_types",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/business_proof_types"
                    }
                },
                "address_proof_types": {
                    "links": {
                        "self": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/address_proof_types",
                        "related": "https://sandbox-api.didww.com/v3/address_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/address_proof_types"
                    }
                }
            }
        }
    ],
    "meta": {
        "total_records": 2,
        "api_version": "2026-04-16"
    },
    "links": {
        "first": "https://sandbox-api.didww.com/v3/address_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "last": "https://sandbox-api.didww.com/v3/address_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50"
    }
}

Other Responses

Code	Success	Description
401	No	Unauthorized