Ramp: Fetch a financing application — response body — controlling officer address, birth date, email, first name, is beneficial owner, last name, ownership percentage, passport last 4, phone, ssn last 4, title
Fetch a financing application: response body, field controlling_officer / address, birth_date, email, first_name, is_beneficial_owner, last_name, ownership_percentage, passport_last_4, phone, ssn_last_4, title. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Fetch a financing application — response body — controlling officer address, birth date, email, first name, is beneficial owner, last name, ownership percentage, passport last 4, phone, ssn last 4, title
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
address | JSON | Optional | |
address (anyOf 1) | Model | Alternative | Expand Fetch a financing application — response body — controlling officer address, birth date, email, first name, is beneficial owner, last name, ownership percentage, passport last 4, phone, ssn last 4, title address apt suite, city, country, postal code, state, street address Residential address. Default: null |
address (anyOf 2) | null | Alternative | |
birth_date | JSON | Optional | |
birth_date (anyOf 1) | string | Alternative | Date of birth in YYYY-MM-DD format. Default: null |
birth_date (anyOf 2) | null | Alternative | |
email | JSON | Optional | |
email (anyOf 1) | string | Alternative | Email address. Default: null Format: email |
email (anyOf 2) | null | Alternative | |
first_name | JSON | Optional | |
first_name (anyOf 1) | string | Alternative | First name. Default: null |
first_name (anyOf 2) | null | Alternative | |
is_beneficial_owner | boolean | Optional | Whether this officer is also a beneficial owner. Defaults to false. Default: false |
last_name | JSON | Optional | |
last_name (anyOf 1) | string | Alternative | Last name. Default: null |
last_name (anyOf 2) | null | Alternative | |
ownership_percentage | JSON | Optional | |
ownership_percentage (anyOf 1) | JSON | Alternative | |
ownership_percentage (anyOf 1) (anyOf 1) | integer | Alternative | Beneficial ownership percentage for this individual. Default: null Maximum: 100 Minimum: 0 |
ownership_percentage (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
ownership_percentage (anyOf 2) | null | Alternative | |
passport_last_4 | JSON | Optional | |
passport_last_4 (anyOf 1) | string | Alternative | Last 4 digits of passport number. Default: null Maximum length: 4 Minimum length: 4 |
passport_last_4 (anyOf 2) | null | Alternative | |
phone | JSON | Optional | |
phone (anyOf 1) | string | Alternative | Phone number in E.164 format. Default: null |
phone (anyOf 2) | null | Alternative | |
ssn_last_4 | JSON | Optional | |
ssn_last_4 (anyOf 1) | string | Alternative | Last 4 digits of SSN. Default: null Maximum length: 4 Minimum length: 4 |
ssn_last_4 (anyOf 2) | null | Alternative | |
title | JSON | Optional | |
title (anyOf 1) | string | Alternative | Job title or role. Default: null |
title (anyOf 2) | null | Alternative |