Skip to navigation

Get the account's boleto beneficiary

Live beneficiary of this account. lastEvent carries the latest notice from the settlement bank (the same data as the boleto.charge.beneficiary.* webhooks). 404 boleto_charge_beneficiary_not_found when the holder has no beneficiary; if a notice exists (for example, a rejected registration), it comes in details.lastEvent. Requires boleto_charge.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.

Response

Beneficiary
beneficiaryIdstringOptional

Settlement-bank beneficiary id.

identifierstringOptional
Beneficiary identifier.
statusenumOptional
Beneficiary status.
Allowed values:
relationshipStatusenumOptional
Relationship with the settlement bank.
Allowed values:
relationshipActivebooleanOptional
True when the relationship is active.
personTypeenumOptional
Allowed values:
taxNumberstringOptional
namestringOptional
legalNamestringOptional
tradeNamestringOptional
socialNamestringOptional
relationshipStartDatedateOptional
relationshipClosedAtdatetimeOptional
emailstringOptional
phonestringOptional
representativeNamestringOptional
representativeEmailstringOptional
representativePhonestringOptional
alertOriginatorslist of stringsOptional
ISPBs of institutions that raised alerts about this beneficiary.
updateddatetimeOptional
accountIdstringOptional
Present on the tenant list, when the tax number matches an account.
lastEventobjectOptional

Latest notice from the settlement bank about this account’s beneficiary. Same data as the boleto.charge.beneficiary.* webhooks. Absent until the first notice.

Errors

403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error