AddressRequirement
The fields an address needs.
Operations
Every route this entity exposes. Each route links to its own reference on this page.
| Method | Route | SDK operation | Returns |
|---|---|---|---|
POST |
/address-requirements |
create |
OK - Successfully retrieved address requirements |
GET |
/address-requirements |
list |
OK - Successfully retrieved address requirements |
Examples
One example per SDK, generated from the API model. The argument names are the parameters and fields of this entity, and the values are placeholders. The examples are not compiled or executed.
Golang
Construct client as shown in the Golang setup, then call the operations:
address_requirements, err := client.AddressRequirement(nil).List(nil, nil)
if err != nil {
panic(err)
}
fmt.Println(address_requirements)
created, err := client.AddressRequirement(nil).Create(map[string]any{"details": map[string]any{}}, nil)
if err != nil {
panic(err)
}
fmt.Println(created)
Lua
Construct client as shown in the Lua setup, then call the operations:
local address_requirements, err = client:AddressRequirement():list()
local created, err = client:AddressRequirement():create({ details = {} })
PHP
Construct client as shown in the PHP setup, then call the operations:
$address_requirements = $client->AddressRequirement()->list();
$created = $client->AddressRequirement()->create(["details" => []]);
Python
Construct client as shown in the Python setup, then call the operations:
address_requirements = client.AddressRequirement().list()
created = client.AddressRequirement().create({ "details": {} })
Ruby
Construct client as shown in the Ruby setup, then call the operations:
address_requirements = client.AddressRequirement.list()
created = client.AddressRequirement.create({ "details" => {} })
TypeScript
Construct client as shown in the TypeScript setup, then call the operations:
const address_requirements = await client.AddressRequirement().list()
const created = await client.AddressRequirement().create({ details: {} })
Fields
| Field | Type | Required | Description |
|---|---|---|---|
details |
object |
Yes | Address details to provide context for requirements lookup. |
fields |
array |
No | List of fields required for the address. |
profile |
integer |
No | User profile ID. |
type |
string |
No | Always "address". |
create
POST /address-requirements
Operation ID: addressRequirementsPost.
Authentication: bearer token (UserToken) or bearer token (PersonalToken).
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
X-External-Correlation-Id |
header |
string (uuid) |
No | Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more. |
Request body
application/json
| Property | Type | Required | Description |
|---|---|---|---|
details |
object |
Yes | Address details to provide context for requirements lookup. Additional fields beyond those listed are accepted. |
details.country |
string |
Yes | Country code (ISO 3166-2 Country Code). |
details.state |
string |
No | State code. Provide to discover state-dependent fields. |
profile |
integer (int64) |
No | User profile ID. |
Example request body:
{
"details": {
"country": "US"
}
}
Responses
200: OK - Successfully retrieved address requirements
application/json
| Property | Type | Required | Description |
|---|---|---|---|
[].fields |
array of object |
No | List of fields required for the address. |
[].fields[].group |
array of object |
No | |
[].fields[].group[].displayFormat |
string,null |
No | Display format pattern. |
[].fields[].group[].example |
string |
No | Example value to help users understand what to input. |
[].fields[].group[].key |
string |
No | Key name to include in the JSON request. |
[].fields[].group[].maxLength |
integer,null (int32) |
No | Maximum valid length of field value. |
[].fields[].group[].minLength |
integer,null (int32) |
No | Minimum valid length of field value. |
[].fields[].group[].refreshRequirementsOnChange |
boolean |
No | If true, call POST address-requirements when this field value changes to discover additional required fields. |
[].fields[].group[].required |
boolean |
No | Indicates if the field is mandatory. |
[].fields[].group[].type |
enum: text, select |
No | Display type of field. |
[].fields[].group[].validationAsync |
string,null |
No | Deprecated. This validation will instead be performed when submitting the request. |
[].fields[].group[].validationRegexp |
string,null |
No | Regexp validation pattern. |
[].fields[].group[].valuesAllowed |
array of object |
No | List of allowed values (for select fields). |
[].fields[].group[].valuesAllowed[].key |
string |
No | Value key to use in the request. |
[].fields[].group[].valuesAllowed[].name |
string |
No | Display name for the value. |
[].fields[].name |
string |
No | Display name of the field. |
[].type |
string |
No | Always "address". |
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header
application/json
The response is object.
list
GET /address-requirements
Operation ID: addressRequirementsGet.
Authentication: bearer token (UserToken) or bearer token (PersonalToken).
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
X-External-Correlation-Id |
header |
string (uuid) |
No | Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more. |
Responses
200: OK - Successfully retrieved address requirements
application/json
| Property | Type | Required | Description |
|---|---|---|---|
[].fields |
array of object |
No | List of fields required for the address. |
[].fields[].group |
array of object |
No | |
[].fields[].group[].displayFormat |
string,null |
No | Display format pattern. |
[].fields[].group[].example |
string |
No | Example value to help users understand what to input. |
[].fields[].group[].key |
string |
No | Key name to include in the JSON request. |
[].fields[].group[].maxLength |
integer,null (int32) |
No | Maximum valid length of field value. |
[].fields[].group[].minLength |
integer,null (int32) |
No | Minimum valid length of field value. |
[].fields[].group[].refreshRequirementsOnChange |
boolean |
No | If true, call POST address-requirements when this field value changes to discover additional required fields. |
[].fields[].group[].required |
boolean |
No | Indicates if the field is mandatory. |
[].fields[].group[].type |
enum: text, select |
No | Display type of field. |
[].fields[].group[].validationAsync |
string,null |
No | Deprecated. This validation will instead be performed when submitting the request. |
[].fields[].group[].validationRegexp |
string,null |
No | Regexp validation pattern. |
[].fields[].group[].valuesAllowed |
array of object |
No | List of allowed values (for select fields). |
[].fields[].group[].valuesAllowed[].key |
string |
No | Value key to use in the request. |
[].fields[].group[].valuesAllowed[].name |
string |
No | Display name for the value. |
[].fields[].name |
string |
No | Display name of the field. |
[].type |
string |
No | Always "address". |
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header
application/json
The response is object.