The identity and technical contract details declared by the specification.
AbilityStatus
string
The current status of the ability
BusinessIndustryType
string
Industry Type Business industry/sector classification
IdentificationLinkparams
object
Direct Identification Params The params required to create an identification
1 property
Crypto
object
A cryptocurrency
2 properties
2 required
BusinessQuestionnairePlannedActivities
object
Planned Activities Section Information about the company's intended account use and transaction patterns
7 properties
4 required
IdentificationCreateParamsV2_IdentificationBusinessParams
Identification Create Params V2 The params required to create an identification v2, we support three types of identification: - Link: where a link is provided…
IdentificationCreateParamsV2
object
Identification Create Params V2 The params required to create an identification v2, we support three types of identification: - Link: where a link is provided…
Signing
object
Signing A signing of a document by a customer
6 properties
4 required
SolePropBusinessQuestionnaire
object
KYB compliance questionnaire for sole proprietorships
3 properties
3 required
SubmitAuthenticationCodeParams
object
Authentication Code Params Parameters for submitting an authentication code
1 property
1 required
BusinessQuestionnaireBusinessDetails
object
Business Details Section Industry classification and operational information about the company
6 properties
6 required
ApiFiatAbilities
object
Fiat rails Customer's ability to use fiat deposit and payout rails
3 properties
3 required
CustomerStatus
string
The status of the Customer
ApproximateNetWorth
string
Approximate Net Worth The approximate net worth of the person
RevenueSource
string
Revenue Source Primary source of company funds
PersonProfileSourceOfFunds
string
Source of Funds The sources of funds for a person
CompanyInfo
object
Company Info Identifying details about a company. Shared between the root identification request and any nested business beneficiaries so the same fields are c…
12 properties
11 required
BusinessBeneficiaryInfo
object
Business Beneficiary Info A company that itself owns or controls the parent business. Carries the same ApiCompanyData as the root identification: company info,…
1 property
1 required
IdentificationStepStatus
object
RequirementCode
string
Stable, switchable identifier for a single requirement. Partners should branch on this rather than parsing description, which holds the verbatim text from Sums…
UsdAbilities
object
10 properties
10 required
Currency
object
Currency Can be either crypto or fiat
Blockchain
string
Blockchain A type of blockchain
Currency_Fiat
Currency Can be either crypto or fiat
BusinessEstimatedMonthlyTransactions
string
Estimated Monthly Transaction Count Expected number of transactions per month
CustomerSpendingLimitSection
object
Customer Spending Limit Section Usage of the rolling 52-week spending limit for a single direction (fiat on-ramp or crypto off-ramp). Amounts are returned in E…
5 properties
3 required
GbpAbilities
object
6 properties
6 required
CompanyType
string
Company Type The type of company
IdentificationCreateParamsV2_IdentificationTokenParams
Identification Create Params V2 The params required to create an identification v2, we support three types of identification: - Link: where a link is provided…
BusinessQuestionnaire_GenericBusinessQuestionnaire
KYB compliance questionnaire Use GenericBusinessQuestionnaire for all company types except sole proprietorships. Use SolePropBusinessQuestionnaire for sole pro…
SigningCreateParams
object
Params for Creating a Signing
2 properties
1 required
PagedList_Identification
object
PagedList A list of items with cursors used to fetch the next or previous page
3 properties
1 required
CompanyBeneficiary
object
Company Beneficial Owner The beneficial owner of the company
5 properties
2 required
UpdateCustomerParams
object
Update Customer Params Parameters for updating a customer
2 properties
1 required
BusinessEstimatedAnnualRevenue
string
Estimated Annual Revenue Company's estimated annual revenue in EUR
Customer
object
Customer The customer object in Iron
14 properties
10 required
BusinessEstimatedMonthlyVolume
string
Estimated Monthly Transaction Volume Expected monthly transaction volume in EUR
IdentificationPersonParams
object
Person Identification Params The params required to create an identification
15 properties
12 required
BirthPlace
object
Birth place The place of birth of the person
3 properties
3 required
PersonProfileExpectedMonthlyTransactionVolume
string
Expected Monthly Transaction Volume The expected monthly transaction volume of the person
PersonProfileYearlyGrossIncome
string
Yearly Gross Income The yearly gross income of the person
CustomerSpendingLimit
object
Customer Spending Limit Current usage of the rolling 52-week spending limit split by direction.
2 properties
2 required
ApiError
object
Standard error response returned to API clients for server errors. Includes a traceid that clients can reference when reporting issues.
2 properties
2 required
EddQuestionnaire
object
EDD Questionnaire The questionnaire for a reliance person residing in a country considered high risk
3 properties
3 required
BeneficiaryIdentity
object
Beneficiary Identity Document Identity document and biometric information for a person beneficiary. Mirrors ApiPersonIdentity but excludes ipaddress (collected…
8 properties
4 required
BusinessQuestionnaire
object
KYB compliance questionnaire Use GenericBusinessQuestionnaire for all company types except sole proprietorships. Use SolePropBusinessQuestionnaire for sole pro…
Currency_Crypto
Currency Can be either crypto or fiat
EmploymentStatus
string
Employment Status The employment status of the person
IdentificationBusinessParams
object
Business Identification Params The params required to create an identification
4 properties
4 required
PersonIdentity
object
Person Identity The required identity information of a person
9 properties
7 required
CompanyDocParams
object
Company document params The params required to create a company document
3 properties
3 required
AutorampType
string
Autoramp type The type (onramp, offramp, swap) of an autoramp
BusinessQuestionnaireSourceOfFunds
object
Source of Funds Section Information about where the company's funds originate
3 properties
3 required
BusinessQuestionnaire_SolePropBusinessQuestionnaire
KYB compliance questionnaire Use GenericBusinessQuestionnaire for all company types except sole proprietorships. Use SolePropBusinessQuestionnaire for sole pro…
IdentityDocumentType
string
Identity Document Type The type of identity document useful to KYB process
IntendedUse
string
Intended Purpose The intended purpose the person wants to use the account for
SolePropPlannedActivities
object
Sole Prop Planned Activities Section
3 properties
3 required
IdentificationStatus
string
The Process status of the identification The various state transitions an identification can go through.
BusinessPurposeAndIntendedUse
string
Purpose and Intended Use The intended purpose of the business account
PersonProfileMonthlyIncome
string
Monthly Income The monthly income of the person
TermsAndConditionsLink
object
A terms and conditions link
3 properties
3 required
IdentityDocument
object
Identity Document A base64 document that can be used to identify the business
3 properties
3 required
CurrencyAbility
object
What a customer can do with a single currency. currency reuses the shared ApiCurrency type; flows reuses AutorampType. The flow rules live in currencyabilities…
3 properties
3 required
KycQuestionnaire
object
KYC Questionnaire The questionnaire for a person
5 properties
5 required
Occupation
string
Occupation The occupation of the person
PagedList_Signing
object
PagedList A list of items with cursors used to fetch the next or previous page
3 properties
1 required
CreateCustomerParams
object
Customer Params Parameters for creating a customer
4 properties
2 required
CompanyData
object
Company Data Full company submission: identifying info, beneficiaries, and supporting documents. Reused by the root identification request and by each nested b…
3 properties
3 required
IdentificationTokenParams
object
Token Identification Params The params required to create an identification
5 properties
2 required
PersonIdentificationStepStatus
object
4 properties
MissingQuestion
object
A required questionnaire question the customer has left unanswered, resolved against the Sumsub questionnaire definition.
3 properties
2 required
CustomerType
string
CustomerType Customers can either be a commercial business or a natural person
IdentificationCreateParamsV2_IdentificationLinkparams
Identification Create Params V2 The params required to create an identification v2, we support three types of identification: - Link: where a link is provided…
PersonBeneficiaryInfo
object
Company Person Beneficiary Info The beneficiary info of the person
12 properties
9 required
DocumentType
string
Document Type The type of document used in the KYB process
RequirementCategory
string
Coarse summary of which areas of the customer's Sumsub KYC/KYB process still need attention. Used as a quick filter — full detail lives in the four complete/pe…
CustomerRequirements
object
Bridge-style requirements view of a customer. All four buckets are always present (may be empty). requirementsdue is a quick coarse summary — partners can use…
5 properties
5 required
CompanyDocType
string
Company document type The type of company document
PersonProfileExpectedMonthlyTransactionVolumeV2
string
GenericBusinessQuestionnaire
object
KYB compliance questionnaire for standard company types
3 properties
3 required
Microdeposit
object
Microdeposit A microdeposit record for account verification
4 properties
3 required
CompanyPrimaryBeneficiaryRole
string
Beneficial Owner Role The role of the beneficial owner in the company
PersonProfileSourceOfWealth
string
Source of Wealth The source of wealth of the person
VerificationStepDetail
object
3 properties
2 required
EurAbilities
object
4 properties
4 required
Address
object
Address
6 properties
4 required
PagedList_Customer
object
PagedList A list of items with cursors used to fetch the next or previous page
3 properties
1 required
AuthenticationCode
object
An authentication code used to confirm a 2FA action
5 properties
5 required
PersonProfileExpectedMonthlyTransactionCount
string
Expected Monthly Transaction Count The expected monthly transaction volume of the person
RejectReason
object
A Sumsub rejection reason: the stable code paired with a human-readable description, so partners can display the reason without maintaining their own code→text…
2 properties
2 required
Fiat
object
A fiat currency
1 property
1 required
SolePropBusinessDetails
object
Sole Prop Business Details Section
4 properties
4 required
BusinessIdentificationStepStatus
object
4 properties
Identification
object
Identification The entity wrapping our KYC/KYB process and underlying providers
11 properties
4 required
RequirementItem
object
A single requirement entry returned in one of the four buckets on ApiCustomerRequirements.
7 properties
4 required
ComplianceQuestionaire
object
V1 Compliance Questionnaire Legacy compliance questionnaire format
8 properties
2 required
CustomerAbilities
object
Customer Abilities Represents the abilities/capabilities that a customer has
3 properties
3 required
CompanyBeneficiaryInfo
object
Company Beneficiary Info The beneficiary info of the company
AuthenticationCodeStatus
string
The status of the Authentication Code
IdentificationCreateParamsV2_IdentificationPersonParams
Identification Create Params V2 The params required to create an identification v2, we support three types of identification: - Link: where a link is provided…
SolePropSourceOfFunds
object
Sole Prop Source of Funds Section
1 property
1 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Unstoppable Finance (Iron) publishes across the network.