IndividualSoleTraderRequest

object
partyTypestringrequired

Party type. Allowed values: INDIVIDUAL, ENTITY

Match pattern:(?=^(INDIVIDUAL|ENTITY)$)(?=^(INDIVIDUAL)$)

rolestringrequired

Party role. Allowed values: BUYER, SELLER

Match pattern:^(BUYER|SELLER)$

externalPartyIdstring

Optional integrator-supplied identifier for this party. May be any string value up to 50 characters (for example, an identifier from your own system) — it does not need to be a UUID. If provided, it is echoed back in the corresponding party in the response so you can correlate your party to the PEXA partyId. Must be unique across the parties in the request. If omitted, only the PEXA-assigned partyId is returned for that party. It is recommended to always supply this value so party correlation is unambiguous.

<= 50 characters

Example:cust123

partySubTypestringrequired

Subtype of the individual party. Use “SELF” for a standard individual or “SOLE_TRADER” for a sole trader.

Match pattern:(?=^(SELF|SOLE_TRADER)$)(?=^(SOLE_TRADER)$)

firstNamestring

>= 1 characters<= 50 characters

middleNamesstring

>= 1 characters<= 50 characters

familyNamestringrequired

>= 1 characters<= 50 characters

dateOfBirthstring(date)
countryCodestringrequired

Country calling code, e.g. “+61”

Match pattern:^\+[0-9]{1,4}$

>= 1 characters<= 5 characters

Example:+61

mobileNumberstringrequired

Must contain between 8 and 20 digits

Match pattern:^[\d\s\-\+\(\)]{8,25}$

>= 8 characters<= 20 characters

emailstring(email)required

Email address

Match pattern:^[A-Za-z0-9+_.-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$

<= 320 characters

abnstring

Australian Business Number (ABN) or Australian Company Number (ACN). Required when partySubType is SOLE_TRADER.

entityNamestringrequired

Trading entity name. Required when partySubType is SOLE_TRADER.

>= 1 characters<= 100 characters

tradingNamestring

Trading name or business name.

>= 1 characters<= 100 characters

mainBusinessLocationstringrequired

State and postcode. Required when partySubType is SOLE_TRADER.

>= 1 characters<= 20 characters

Example:SA 5045

Example

EntityPartyBase

object

Common entity (organisation) party fields shared by the workspace-creation entity request and the add-party entity request. Does not include the discriminator base fields (partyType pattern / role), which differ per usage and are supplied by the referencing schema.

partySubTypestringrequired

Organisation subtype. Allowed values: TRUST, BODY_CORPORATE_COMPANY, PARTNERSHIP_ASSOCIATION, GOVERNMENT_BODY, OTHER

Match pattern:^(TRUST|BODY_CORPORATE_COMPANY|PARTNERSHIP_ASSOCIATION|GOVERNMENT_BODY|OTHER)$

partySubTypeDescriptionstring

Required when partySubType is OTHER. Must not be provided otherwise.

Match pattern:^[a-zA-Z0-9 \-&/()]+$

>= 3 characters<= 100 characters

servicingModestringrequired

Servicing mode. Allowed values: SELF_SERVE, ASSISTED

Match pattern:^(SELF_SERVE|ASSISTED)$

entityNamestringrequired

>= 4 characters<= 100 characters

abnstring

Australian Business Number (ABN) or Australian Company Number (ACN)

tradingNamestring

Trading name or business name

>= 1 characters<= 100 characters

mainBusinessLocationstringrequired

State and postcode in format ‘STATE POSTCODE’ (e.g. VIC 3000, NSW 2000)

Match pattern:^[A-Z]{2,3} [0-9]{4}$

>= 6 characters<= 8 characters

Example:VIC 3000

primaryContactobject

Required when servicingMode is ASSISTED. Contact details for the primary person managing the entity verification.

Show Child Parameters
Example

EntityPartyRequest

object

Entity party for AML verification (workspace creation). Supports trusts, companies, partnerships, government bodies, and other organisation types.

partyTypestringrequired

Party type. Allowed values: INDIVIDUAL, ENTITY

Match pattern:(?=^(INDIVIDUAL|ENTITY)$)(?=^(ENTITY)$)

rolestringrequired

Party role. Allowed values: BUYER, SELLER

Match pattern:^(BUYER|SELLER)$

externalPartyIdstring

Optional integrator-supplied identifier for this party. May be any string value up to 50 characters (for example, an identifier from your own system) — it does not need to be a UUID. If provided, it is echoed back in the corresponding party in the response so you can correlate your party to the PEXA partyId. Must be unique across the parties in the request. If omitted, only the PEXA-assigned partyId is returned for that party. It is recommended to always supply this value so party correlation is unambiguous.

<= 50 characters

Example:cust123

partySubTypestringrequired

Organisation subtype. Allowed values: TRUST, BODY_CORPORATE_COMPANY, PARTNERSHIP_ASSOCIATION, GOVERNMENT_BODY, OTHER

Match pattern:^(TRUST|BODY_CORPORATE_COMPANY|PARTNERSHIP_ASSOCIATION|GOVERNMENT_BODY|OTHER)$

partySubTypeDescriptionstring

Required when partySubType is OTHER. Must not be provided otherwise.

Match pattern:^[a-zA-Z0-9 \-&/()]+$

>= 3 characters<= 100 characters

servicingModestringrequired

Servicing mode. Allowed values: SELF_SERVE, ASSISTED

Match pattern:^(SELF_SERVE|ASSISTED)$

entityNamestringrequired

>= 4 characters<= 100 characters

abnstring

Australian Business Number (ABN) or Australian Company Number (ACN)

tradingNamestring

Trading name or business name

>= 1 characters<= 100 characters

mainBusinessLocationstringrequired

State and postcode in format ‘STATE POSTCODE’ (e.g. VIC 3000, NSW 2000)

Match pattern:^[A-Z]{2,3} [0-9]{4}$

>= 6 characters<= 8 characters

Example:VIC 3000

primaryContactobject

Required when servicingMode is ASSISTED. Contact details for the primary person managing the entity verification.

Show Child Parameters
Example

Workspace

object
workspaceIdstring(uuid)required
workspaceReferencestring
externalReferencestring

Integrator-supplied reference echoed from the request

workspaceUrlstring(uri)

URL to access the workspace in PEXA Clear

partiesarray[object]required

The parties created in the workspace during initiation. Each entry includes the PEXA-assigned partyId, the integrator-supplied externalPartyId (echoed back when provided, otherwise null), and the party details. Use partyId (or externalPartyId when supplied) to reference a party in subsequent calls.

Show Child Parameters
Example

PartyResponse

object
partyIdstring(uuid)required

PEXA-assigned party identifier

externalPartyIdstringrequired

The integrator-supplied identifier echoed from the request for this party. Null when no externalPartyId was supplied for the party.

<= 50 characters

Example:cust123

partyTypestringrequired

Party type echoed from the request

Allowed values:INDIVIDUALENTITY

rolestringrequired

Party role echoed from the request

Allowed values:BUYERSELLER

partyDetailsobjectrequired

The submitted party details echoed back (e.g. names, contact, entity information), so each returned party is self-describing and can be matched to the party you submitted.

* Additional properties are allowed.
Example