Ramp: Create a financing application — request body — body
Create a financing application: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Create a financing application — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
applicant | Model | Required within parent | Expand Fetch a financing application — response body — applicant Information about the applicant, the person who completes the application in Ramp and becomes the business owner once it is approved. |
application_type | string | Optional | Type of financing application to create. Default: RAMP_SUITE One of: BILL_PAY_ONLY, RAMP_SUITE |
beneficial_owners | JSON | Optional | |
beneficial_owners (anyOf 1) | array | Alternative | Beneficial owners of the business. |
beneficial_owners (anyOf 1)[] | Model | Each item | Expand Create a financing application — request body — body beneficial owners Beneficial owners of the business item |
beneficial_owners (anyOf 2) | null | Alternative | |
business | JSON | Optional | |
business (anyOf 1) | Model | Alternative | Expand Create a financing application — request body — body business address, business description, business name dba, business name legal, business name on card, business website, incorporation, phone Business details. Default: null |
business (anyOf 2) | null | Alternative | |
controlling_officer | JSON | Optional | |
controlling_officer (anyOf 1) | Model | Alternative | Expand Create a financing application — request body — body controlling officer address, birth date, email, first name, is beneficial owner, last name, ownership percentage, passport last 4, phone, ssn last 4, title The controlling officer of the business. Default: null |
controlling_officer (anyOf 2) | null | Alternative | |
country | string | Optional | Country where the business is incorporated. GB applications only accept applicant details and basic business information; the applicant completes the rest of the application in Ramp. Default: US One of: GB, US |
financial_details | JSON | Optional | |
financial_details (anyOf 1) | Model | Alternative | Expand Create a financing application — request body — body financial details estimated monthly ap spend amount, estimated monthly spend amount Financial details for underwriting. Default: null |
financial_details (anyOf 2) | null | Alternative | |
lead_referral_partner_channel | JSON | Optional | |
lead_referral_partner_channel (anyOf 1) | string | Alternative | Optional unverified agent harness that reported the lead_referral_partner_code. Default: null One of: api, cli, mcp |
lead_referral_partner_channel (anyOf 2) | null | Alternative | |
lead_referral_partner_code | JSON | Optional | |
lead_referral_partner_code (anyOf 1) | string | Alternative | Optional unverified agent-reported Ramp partner code for agent financing application lead attribution. Default: null One of: base44, clerky, cofounder_co, every, nous_research_hermes, paperclip, south_park_commons, yc |
lead_referral_partner_code (anyOf 2) | null | Alternative | |
manual_bank_account | JSON | Optional | |
manual_bank_account (anyOf 1) | Model | Alternative | Expand Create a financing application — request body — body manual bank account account number, account subtype, balance, routing number Manual bank account to add for underwriting. Default: null |
manual_bank_account (anyOf 2) | null | Alternative | |
oauth_authorize_params | JSON | Optional | |
oauth_authorize_params (anyOf 1) | Model | Alternative | Expand Create a financing application — request body — body oauth authorize params code challenge, redirect uri, state OAuth authorization parameters. If provided, the user will be redirected to an OAuth consent screen after accepting the invite. Default: null |
oauth_authorize_params (anyOf 2) | null | Alternative | |
ownership_acknowledgement | JSON | Optional | |
ownership_acknowledgement (anyOf 1) | string | Alternative | Ownership acknowledgement confirming whether all 25%+ beneficial owners have been supplied. Default: null One of: CONFIRM_ALL_MAJOR_OWNERS_ENTERED, CONFIRM_NO_INDIVIDUAL_OWNS_25_PCT |
ownership_acknowledgement (anyOf 2) | null | Alternative |
Referenced models: Fetch a financing application — response body — applicant, Create a financing application — request body — body business address, business description, business name dba, business name legal, business name on card, business website, incorporation, phone, Create a financing application — request body — body controlling officer address, birth date, email, first name, is beneficial owner, last name, ownership percentage, passport last 4, phone, ssn last 4, title, Create a financing application — request body — body financial details estimated monthly ap spend amount, estimated monthly spend amount, Create a financing application — request body — body manual bank account account number, account subtype, balance, routing number, Create a financing application — request body — body oauth authorize params code challenge, redirect uri, state, Create a financing application — request body — body beneficial owners Beneficial owners of the business item