Skip to content
synpute

Entities

Create an entity

Preview

Register a legal entity so it can be verified, granted access or named in records. Synpute assigns the ID; the prefix follows the role.

post/v1/entities

Body parameters

jurisdictionstringrequired
Place of incorporation, ISO 3166-2
legal_namestringrequired
Registered legal name
registration_numberstringrequired
Company registry number
rolestringrequired
Role
operatorbuyerlenderplatform

Response 201 · Entity

beneficial_ownersarray of objectrequired
Owners of 25% or more, as declared and verified
+Show properties
namestring
Full name
share_pctnumber
Ownership share, percent
verifiedboolean
Identity verified against documents
createdstringrequired
When the record was created
idSynpute IDrequired
Synpute ID; the prefix gives the role
jurisdictionstringrequired
Place of incorporation, ISO 3166-2
legal_namestringrequired
Registered legal name
objectstringrequired
Object type
registration_numberstringrequired
Company registry number
rolestringrequired
Role in the market
operatorbuyerlenderplatform
verificationVerificationSummaryrequired
Latest status of each check
+Show properties
checked_atstring
When the most recent check finished
checksarray of object
One entry per check that has run
+Show properties
statusstring
Result
verifiedclearflaggedfailedpending
typestring
Check
kybbeneficial_ownerssanctionsserialsownershipucc_lienssite_leasepower_contract
statusstring
Rolled-up status
verifiedpartialpendingflagged

Errors

400409return the standard error shape.