Skip to main content

Get business profile

GET/partner/v1/business-profiles/{customerId}
Auth Bearer tokenScope partner.read

Returns one of your business customers. To look one up by your own id, use Get by reference.

Path​

customerIduuidpathrequired

Response​

customerIduuid
partnerCustomerIdstring
companyNamestring
tradingNamestring | null
emailstring
phoneNumberstring | null
businessTypeCodestring | null
incorporationCountryIso3Codestring
ISO 3166-1 alpha-3.
industrystring | null
descriptionstring | null
websitestring | null
registrationNumberstring
registrationDatedate | null
YYYY-MM-DD.
addressesAddress[]

Same shape as on create. Empty when the business has no address.

Show Address propertiesHide Address properties
streetLine1string
streetLine2string | null
citystring
statestring
postalCodestring
countryCodestring
financialsobject | null

The business's transaction profile, under the same six names as on create. null for a customer created before it was required on create (2026-11-16). A field with no stored value is an empty string.

Show Financials propertiesHide Financials properties
primarySourceOfFundsstring
Free text.
businessAccountPurposestring
Free text.
monthlyTurnoverstring
monthlyVolumestring
estimatedTransactionValuestring
monthlyTransactionFrequencystring
currentStagestring
verificationStatusstring
createdDateUtcdate-time

Errors​

Only the common errors. For this endpoint, the customer errors mean:

CodeHTTPWhen
Customer.NotFound404No customer has this customerId.
Customer.NotBusiness400The customerId is not a business customer.
Partner.NotAuthorized403The business is not one of yours.

A customerId that is not a UUID matches no route and returns 404 without the response envelope.