API

BusinessProfile

A business profile: create or update one.

Operations

Every route this entity exposes. Each route links to its own reference on this page.

Method Route SDK operation Returns
POST /profiles/business-profile create Created business profile
PUT /profiles/{profileId}/business-profile update Updated business profile

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:

created, err := client.BusinessProfile(nil).Create(map[string]any{"contactDetails": map[string]any{}}, nil)
if err != nil {
    panic(err)
}
fmt.Println(created)
updated, err := client.BusinessProfile(nil).Update(map[string]any{"profile_id": 1, "abn": "example"}, nil)
if err != nil {
    panic(err)
}
fmt.Println(updated)

Lua

Construct client as shown in the Lua setup, then call the operations:

local created, err = client:BusinessProfile():create({ contactDetails = {} })
local updated, err = client:BusinessProfile():update({ profile_id = 1, abn = "example" })

PHP

Construct client as shown in the PHP setup, then call the operations:

$created = $client->BusinessProfile()->create(["contactDetails" => []]);
$updated = $client->BusinessProfile()->update(["profile_id" => 1, "abn" => "example"]);

Python

Construct client as shown in the Python setup, then call the operations:

created = client.BusinessProfile().create({ "contactDetails": {} })
updated = client.BusinessProfile().update({"profile_id": 1, "abn": "example"})

Ruby

Construct client as shown in the Ruby setup, then call the operations:

created = client.BusinessProfile.create({ "contactDetails" => {} })
updated = client.BusinessProfile.update({ "profile_id" => 1, "abn" => "example" })

TypeScript

Construct client as shown in the TypeScript setup, then call the operations:

const created = await client.BusinessProfile().create({ contactDetails: {} })
const updated = await client.BusinessProfile().update({ profile_id: 1, abn: "example" })

Fields

Field Type Required Description
abn one,string,null No Australian Business Number (only for Australian businesses).
acn one,string,null No Australian Company Number (only for Australian businesses).
actorEmail string No Email of the actor.
address object No Main registered address of the business.
arbn one,string,null No Australian Registered Body Number (only for Australian businesses).
businessFreeFormDescription string No Free-form description of the business activities.
businessName string No Registered business name.
businessNameInKatakana one,string,null No Business name in Katakana (only for Japanese businesses).
businessRepresentative object No Business representative details.
companyRole string No Role of the person managing the business profile.
companyType string No Type of company.
contactDetails object No Contact information for the business.
createdAt string No Timestamp when the profile was created (ISO 8601 format).
currentState string No Current status of this profile.
descriptionOfBusiness string No Deprecated.
email string No Primary email address for the business.
externalCustomerId string No An external reference identifier mapping the customer of this profile to your system.
firstLevelCategory string No Deprecated.
fullName string No Full legal name of the business.
id integer No Unique identifier for the profile.
industryCategories array No One or more industry categories classifying the business.
operationalAddresses array No An array of operational addresses for the business.
publicId string No Publicly accessible identifier for the profile.
registrationNumber string No Business registration number.
secondLevelCategory string No Deprecated.
type string Yes Type of profile.
updatedAt string No Timestamp when the profile was last updated (ISO 8601 format).
userId integer No The ID of the user associated with this profile.
webpage string No Business website URL.

create

POST /profiles/business-profile

Operation ID: profileBusinessCreateV3.

Authentication: bearer token (UserToken).

Parameters

Parameter In Type Required Description
X-idempotence-uuid header string (uuid) No Unique idempotency key for the request.
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
abn string,null No Australian Business Number (only for Australian businesses).
acn string,null No Australian Company Number (only for Australian businesses).
actorEmail string No Email of the actor.
address object No
address.addressFirstLine string No First line of address.
address.city string No City.
address.countryIso2Code string No 2 letter country code.
address.countryIso3Code string No 3 letter country code. Must be lowercase.
address.postCode string No Postal code.
address.stateCode string No State code.
arbn string,null No Australian Registered Body Number (only for Australian businesses).
businessFreeFormDescription string No Business free form description. Required if companyType is OTHER. If this is not provided for an OTHER companyType, the profile should not be allowed to create a transfer. For the rest of the companyTypes, it is highly recommended to always provide the business' description, to avoid payment issues such as suspensions. Wise will send a request for information (RFI) if this detail is not provided.
businessName string No Business name.
businessNameInKatakana string,null No Business name in Katakana (only for Japanese businesses).
businessRepresentative object No Business representative details. Provide either the full representative details or just the businessRepresentativeId to link an existing representative.
businessRepresentative.address object No
businessRepresentative.address.addressFirstLine string No First line of address. Required unless Business Representative ID is provided.
businessRepresentative.address.city string No City. Required unless Business Representative ID is provided.
businessRepresentative.address.countryIso3Code string No 3 letter country code (lower case). Required unless Business Representative ID is provided.
businessRepresentative.address.postCode string No Postal code.
businessRepresentative.address.stateCode string No State code (max 5 chars). Required for US, CA, BR and AU addresses unless Business Representative ID is provided.
businessRepresentative.businessRepresentativeId integer No ID of a Business Representative. This can be obtained from a previous call to create a business profile, in which case the same Business Representative is linked to the current business effectively sharing it across multiple businesses. When the Business Representative ID is provided, it is the only field required and none of the other fields should be provided.
businessRepresentative.contactDetails object No
businessRepresentative.contactDetails.email string No Contact email address. Required unless Business Representative ID is provided.
businessRepresentative.contactDetails.phoneNumber string No Contact phone number in international phone number format. Required unless Business Representative ID is provided.
businessRepresentative.dateOfBirth string No Date of birth. Required unless Business Representative ID is provided.
businessRepresentative.firstName string No First name of the person representing the business (including middle names). Required unless Business Representative ID is provided.
businessRepresentative.lastName string No Last name of the person representing the business. Required unless Business Representative ID is provided.
businessRepresentative.localizedInformation array of object No Optional localized information for the business representative. For Kana names, provide both firstName and lastName entries with localeScriptCode set to Kana. Each combination of key and localeScriptCode must be unique.
businessRepresentative.localizedInformation[].key string Yes Name of the field being localized.
businessRepresentative.localizedInformation[].localeScriptCode string Yes Script code for the localized value.
businessRepresentative.localizedInformation[].value string Yes Localized value of the field.
businessRepresentative.preferredName string No Preferred first name, if different to the legal first name.
companyRole enum: OWNER, DIRECTOR, OTHER No Role of person.
companyType enum: LIMITED, PARTNERSHIP, SOLE_TRADER, LIMITED_BY_GUARANTEE, LIMITED_LIABILITY_COMPANY, FOR_PROFIT_CORPORATION, ... No Company legal form.
contactDetails object No Optional contact details for the business, separate from the representative's contact details.
contactDetails.email string (email) Yes Contact email address for the business.
contactDetails.phoneNumber string Yes Contact phone number for the business.
externalCustomerId string No An external reference identifier mapping the customer of this profile to your system.
firstLevelCategory string No Legacy primary business category. Use industryCategories instead. Cannot be combined with industryCategories.
industryCategories array of string No One or more industry categories classifying the business. See Business Categories for the full list of valid values.
operationalAddresses array of object No List of operational addresses.
operationalAddresses[].addressFirstLine string No
operationalAddresses[].city string No
operationalAddresses[].countryIso2Code string No
operationalAddresses[].countryIso3Code string No
operationalAddresses[].postCode string No
operationalAddresses[].stateCode string No
registrationNumber string No Business registration number.
secondLevelCategory string No Legacy secondary business category. Use industryCategories instead. Cannot be combined with industryCategories.
webpage string No Business webpage. Required if companyType is OTHER. If this is not provided for an OTHER companyType, the profile should not be allowed to create a transfer. For the rest of the companyTypes, it is highly recommended to always provide the business' website, to avoid payment issues such as suspensions. Wise will send a request for information (RFI) if this detail is not provided.

Responses

200: Created business profile

application/json

Property Type Required Description
address object No Main registered address of the business.
address.addressFirstLine string No First line of the address.
address.city string No City of the address.
address.countryIso2Code string No Two-letter ISO country code.
address.countryIso3Code string No Three-letter ISO country code.
address.id integer (int64) No ID of the address.
address.postCode string No Postal code of the address.
address.stateCode string,null No State code of the address (can be null for some countries).
businessFreeFormDescription string No Free-form description of the business activities.
businessName string No Registered business name.
companyRole enum: OWNER, DIRECTOR, OTHER No Role of the person managing the business profile.
companyType string No Type of company.
contactDetails object No Contact information for the business.
contactDetails.email string No Contact email address.
contactDetails.phoneNumber string No Contact phone number.
createdAt string (date-time) No Timestamp when the profile was created (ISO 8601 format).
currentState enum: HIDDEN, VISIBLE, DEACTIVATED No Current status of this profile.
descriptionOfBusiness string No Deprecated. New integrations should use industryCategories. See Migrating to industry categories.
email string No Primary email address for the business.
firstLevelCategory string No Deprecated. New integrations should use industryCategories. See Migrating to industry categories. Populated only when the profile was classified with the legacy fields, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats.
fullName string No Full legal name of the business.
id integer (int64) No Unique identifier for the profile.
industryCategories array of string No One or more industry categories classifying the business. See Business Categories for the full list of valid values. Populated only when the profile was classified with industryCategories, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats.
operationalAddresses array of object No An array of operational addresses for the business.
operationalAddresses[].addressFirstLine string No First line of the address.
operationalAddresses[].city string No City of the address.
operationalAddresses[].countryIso2Code string No Two-letter ISO country code.
operationalAddresses[].countryIso3Code string No Three-letter ISO country code.
operationalAddresses[].id integer (int64) No ID of the address.
operationalAddresses[].postCode string No Postal code of the address.
operationalAddresses[].stateCode string,null No State code of the address (can be null for some countries).
publicId string No Publicly accessible identifier for the profile.
registrationNumber string No Business registration number.
secondLevelCategory string No Deprecated. New integrations should use industryCategories. See Migrating to industry categories. Populated only when the profile was classified with the legacy fields, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats, where it may return UNMAPPED if the industryCategories combination has no legacy equivalent.
type enum: BUSINESS Yes Type of profile.
updatedAt string (date-time) No Timestamp when the profile was last updated (ISO 8601 format).
userId integer (int64) No The ID of the user associated with this profile.
webpage string No Business website URL.
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header

application/json

The response is object.

update

PUT /profiles/{profileId}/business-profile

Operation ID: profileBusinessUpdate.

Authentication: bearer token (UserToken) or bearer token (PersonalToken).

Parameters

Parameter In Type Required Description
profileId path integer (int64) Yes Business profile ID.
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
abn string,null No Australian Business Number (only for Australian businesses).
acn string,null No Australian Company Number (only for Australian businesses).
address object No
address.addressFirstLine string No First line of address.
address.city string No City.
address.countryIso2Code string No 2 letter country code.
address.countryIso3Code string No 3 letter country code. Must be lowercase.
address.postCode string No Postal code.
address.stateCode string No State code.
arbn string,null No Australian Registered Body Number (only for Australian businesses).
businessFreeFormDescription string No Business free form description.
businessName string No Business name.
businessNameInKatakana string,null No Business name in Katakana (only for Japanese businesses).
companyRole enum: OWNER, DIRECTOR, OTHER No Role of person.
companyType enum: LIMITED, PARTNERSHIP, SOLE_TRADER, LIMITED_BY_GUARANTEE, LIMITED_LIABILITY_COMPANY, FOR_PROFIT_CORPORATION, ... No Company legal form.
contactDetails object No Optional contact details for the business, separate from the representative's contact details.
contactDetails.email string (email) Yes Contact email address for the business.
contactDetails.phoneNumber string Yes Contact phone number for the business.
externalCustomerId string No An external reference identifier mapping the customer of this profile to your system.
firstLevelCategory string No Legacy primary business category. Use industryCategories instead. Cannot be combined with industryCategories.
id integer (int64) No Business profile ID. This must match the business profile ID supplied in the URL.
industryCategories array of string No One or more industry categories classifying the business. See Business Categories for the full list of valid values.
operationalAddresses array of object No List of operational addresses.
operationalAddresses[].addressFirstLine string No
operationalAddresses[].city string No
operationalAddresses[].countryIso2Code string No
operationalAddresses[].countryIso3Code string No
operationalAddresses[].postCode string No
operationalAddresses[].stateCode string No
registrationNumber string No Business registration number.
secondLevelCategory string No Legacy secondary business category. Use industryCategories instead. Cannot be combined with industryCategories.
webpage string No Business webpage. Required if companyType is OTHER. If this is not provided for an OTHER companyType, the profile should not be allowed to create a transfer. For the rest of the companyTypes, it is highly recommended to always provide the business' website, to avoid payment issues such as suspensions. Wise will send a request for information (RFI) if this detail is not provided.

Responses

200: Updated business profile

application/json

Property Type Required Description
address object No Main registered address of the business.
address.addressFirstLine string No First line of the address.
address.city string No City of the address.
address.countryIso2Code string No Two-letter ISO country code.
address.countryIso3Code string No Three-letter ISO country code.
address.id integer (int64) No ID of the address.
address.postCode string No Postal code of the address.
address.stateCode string,null No State code of the address (can be null for some countries).
businessFreeFormDescription string No Free-form description of the business activities.
businessName string No Registered business name.
companyRole enum: OWNER, DIRECTOR, OTHER No Role of the person managing the business profile.
companyType string No Type of company.
contactDetails object No Contact information for the business.
contactDetails.email string No Contact email address.
contactDetails.phoneNumber string No Contact phone number.
createdAt string (date-time) No Timestamp when the profile was created (ISO 8601 format).
currentState enum: HIDDEN, VISIBLE, DEACTIVATED No Current status of this profile.
descriptionOfBusiness string No Deprecated. New integrations should use industryCategories. See Migrating to industry categories.
email string No Primary email address for the business.
firstLevelCategory string No Deprecated. New integrations should use industryCategories. See Migrating to industry categories. Populated only when the profile was classified with the legacy fields, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats.
fullName string No Full legal name of the business.
id integer (int64) No Unique identifier for the profile.
industryCategories array of string No One or more industry categories classifying the business. See Business Categories for the full list of valid values. Populated only when the profile was classified with industryCategories, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats.
operationalAddresses array of object No An array of operational addresses for the business.
operationalAddresses[].addressFirstLine string No First line of the address.
operationalAddresses[].city string No City of the address.
operationalAddresses[].countryIso2Code string No Two-letter ISO country code.
operationalAddresses[].countryIso3Code string No Three-letter ISO country code.
operationalAddresses[].id integer (int64) No ID of the address.
operationalAddresses[].postCode string No Postal code of the address.
operationalAddresses[].stateCode string,null No State code of the address (can be null for some countries).
publicId string No Publicly accessible identifier for the profile.
registrationNumber string No Business registration number.
secondLevelCategory string No Deprecated. New integrations should use industryCategories. See Migrating to industry categories. Populated only when the profile was classified with the legacy fields, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats, where it may return UNMAPPED if the industryCategories combination has no legacy equivalent.
type enum: BUSINESS Yes Type of profile.
updatedAt string (date-time) No Timestamp when the profile was last updated (ISO 8601 format).
userId integer (int64) No The ID of the user associated with this profile.
webpage string No Business website URL.
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header

application/json

The response is object.