Ramp: Fetch a financing application — response body — beneficial owners Beneficial owners of the business item
Fetch a financing application: response body, field beneficial_owners / Beneficial owners of the business / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Fetch a financing application — response body — beneficial owners Beneficial owners of the business item
| 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 | |
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 |