Ramp: Fetch a financing application — response body
Fetch a financing application: response body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Fetch a financing application — response 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. Known values: BILL_PAY_ONLY, RAMP_SUITE |
beneficial_owners | JSON | Required within parent | |
beneficial_owners (anyOf 1) | array | Alternative | Beneficial owners of the business. |
beneficial_owners (anyOf 1)[] | Model | Each item | Expand Fetch a financing application — response body — beneficial owners Beneficial owners of the business item |
beneficial_owners (anyOf 2) | null | Alternative | |
business | JSON | Required within parent | |
business (anyOf 1) | Model | Alternative | Expand Fetch a financing application — response body — business address, business description, business name dba, business name legal, business name on card, business website, incorporation, phone Business details. |
business (anyOf 2) | null | Alternative | |
controlling_officer | JSON | Required within parent | |
controlling_officer (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 The controlling officer of the business. |
controlling_officer (anyOf 2) | null | Alternative | |
financial_details | JSON | Required within parent | |
financial_details (anyOf 1) | Model | Alternative | Expand Fetch a financing application — response body — financial details estimated monthly ap spend amount, estimated monthly spend amount Financial details for underwriting. |
financial_details (anyOf 2) | null | Alternative | |
id | string | Required within parent | Unique identifier of the application. Format: uuid |
incorporation_status | string | Required within parent | Incorporation status for the business. NOT_INCORPORATED when the business has no incorporation record. Known values: FORMED, INCORPORATED_EXTERNALLY, INCORPORATING, NOT_INCORPORATED |
needs_incorporation | boolean | Required within parent | Whether the business still needs to be incorporated through Ramp. Reflects the needs_incorporation flag supplied at application creation. |
open_ramp_checking_account | boolean | Required within parent | Whether the applicant is applying for a Ramp checking account. For Agent FA, this is always true and external bank linking is unavailable. |
status | string | Required within parent | Current status of the financing application. Known values: APPROVED, FOLLOW_UPS_REQUIRED, IN_REVIEW, REJECTED, STARTED, WITHDRAWN |
Referenced models: Fetch a financing application — response body — applicant, Fetch a financing application — response body — business address, business description, business name dba, business name legal, business name on card, business website, incorporation, phone, 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 — financial details estimated monthly ap spend amount, estimated monthly spend amount, Fetch a financing application — response body — beneficial owners Beneficial owners of the business item