List KYC forms
Get a list of the required KYC forms you need to submit to meet a specific country requirements.
GET
/kyc-forms
List KYC forms
Parametry zapytania
limit
integer
Limits the number of results to return.
reverse
boolean
Reverses the order in which the results are returned.
pageToken
string
The cursor that keeps track of the current position in the results.
countryCode
string
Filter KYC forms by target country.
scope
string
Filter KYC forms by scope.
Possible values: number, organization, channel
Treść odpowiedzi
nextPageToken
string
The token to fetch the next page of results. If empty, there are no more results to fetch.
results
array of object
wymagane
Pokaż atrybuty podrzędne
results.conditions
object
results.countryCode
string
results.createdAt
string
wymagane
results.defaultLocale
string
wymagane
results.gracePeriodDays
integer
results.id
string
wymagane
results.name
string
wymagane
results.questions
array of object
wymagane
Pokaż atrybuty podrzędne
results.questions.locale
string
wymagane
results.questions.questions
array of object
wymagane
Pokaż atrybuty podrzędne
results.questions.questions.conditions
array of object
Pokaż atrybuty podrzędne
results.questions.questions.conditions.key
string
results.questions.questions.conditions.value
string
results.questions.questions.description
string
results.questions.questions.displayName
string
wymagane
results.questions.questions.format
string
wymagane
Possible values: none
results.questions.questions.key
string
wymagane
results.questions.questions.mapping
string
Map the answer to a contact attribute. If not set, the answer will not be mapped.
results.questions.questions.options
array of object
Pokaż atrybuty podrzędne
results.questions.questions.options.key
string
results.questions.questions.options.value
string
results.questions.questions.placeholder
string
results.questions.questions.required
boolean
results.questions.questions.timezone
string
results.questions.questions.type
string
wymagane
Possible values: bool, boolArray, intArray, float, floatArray
results.questions.questions.formQuestionConfig
object
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringDatetimeConfig
object
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringDatetimeConfig.allowTimezoneSelectionByUser
boolean
results.questions.questions.formQuestionConfig.stringDatetimeConfig.datetimeRange
object
wymagane
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringDatetimeConfig.datetimeRange.type
string
Possible values: any, future, past
results.questions.questions.formQuestionConfig.stringDatetimeConfig.defaultTimezone
string
results.questions.questions.formQuestionConfig.stringDatetimeConfig.includeTime
boolean
results.questions.questions.formQuestionConfig.stringDatetimeConfig.localeOverride
string
results.questions.questions.formQuestionConfig.stringDatetimeConfig.timeFormat
string
Possible values: am-pm, 24h
results.questions.questions.formQuestionConfig.stringDatetimeConfig.timePlaceholder
string
results.questions.questions.formQuestionConfig.type
string
Possible values: stringDatetime
results.questions.questions.formQuestionConfig.stringMsisdnConfig
object
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringMsisdnConfig.defaultCountryCode
string
wymagane
results.questions.questions.formQuestionConfig.type
string
Possible values: stringMsisdn
results.questions.questions.formQuestionConfig.stringEmojiConfig
object
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringEmojiConfig.options
array of object
wymagane
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringEmojiConfig.options.emoji
string
wymagane
results.questions.questions.formQuestionConfig.stringEmojiConfig.options.text
string
wymagane
results.questions.questions.formQuestionConfig.type
string
Possible values: stringEmoji
results.questions.questions.formQuestionConfig.stringEnumConfig
object
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringEnumConfig.allowedValues
array of object
wymagane
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringEnumConfig.allowedValues.displayName
string
wymagane
results.questions.questions.formQuestionConfig.stringEnumConfig.allowedValues.imageUrl
string
results.questions.questions.formQuestionConfig.stringEnumConfig.allowedValues.value
string
wymagane
results.questions.questions.formQuestionConfig.stringEnumConfig.columns
integer
results.questions.questions.formQuestionConfig.stringEnumConfig.cornerRadius
string
Possible values: none, normal, full
results.questions.questions.formQuestionConfig.stringEnumConfig.optionSize
string
Possible values: small, medium, large
results.questions.questions.formQuestionConfig.stringEnumConfig.showLabels
boolean
results.questions.questions.formQuestionConfig.stringEnumConfig.singleSelect
boolean
results.questions.questions.formQuestionConfig.stringEnumConfig.withImages
boolean
results.questions.questions.formQuestionConfig.type
string
Possible values: stringEnum
results.questions.questions.formQuestionConfig.stringS3ObjectConfig
object
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringS3ObjectConfig.allowedMimeType
string
wymagane
Allowed type to upload. Supports wildcards.
results.questions.questions.formQuestionConfig.stringS3ObjectConfig.maxFileSize
integer
wymagane
results.questions.questions.formQuestionConfig.stringS3ObjectConfig.templateFileUrl
string
URL to a template file that can be downloaded by the user and uploaded back.
results.questions.questions.formQuestionConfig.type
string
Possible values: stringS3Object
results.questions.questions.formQuestionConfig.stringCustomConfig
object
Pokaż atrybuty podrzędne
results.questions.questions.formQuestionConfig.stringCustomConfig.message
string
Validation message to show when validation fails.
results.questions.questions.formQuestionConfig.stringCustomConfig.regexp
string
wymagane
Regular expression to validate the input against.
results.questions.questions.formQuestionConfig.stringCustomConfig.title
string
wymagane
Validation title.
results.questions.questions.formQuestionConfig.type
string
Possible values: stringCustom
results.questions.questions.ui:type
string
hint the UI what form to show if type isn't sufficient
Possible values: shortText, longText, dropdown, radio, checkboxSelect
results.scope
string
wymagane
Possible values: number, organization, channel
results.status
string
wymagane
Possible values: draft, active, deactivated
results.updatedAt
string
wymagane
Przykład kodu
curl -X GET 'https://api.bird.com/kyc-forms' \
-H 'Authorization: AccessKey YOUR_ACCESS_KEY'