API

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.