---
title: "Create an application"
method: POST
path: "/applications"
tags: ["Applications"]
---

# Create an application

`POST /applications`

## Request

- Base URL: `https://production.pier-finance.com/api`
- URL: `https://production.pier-finance.com/api/applications`
- Auth: HTTP bearer

## Request body

- object
  - `borrower_id` string, required: The `borrower_id` of the borrower the application is for (1-256 chars)
  - `credit_type` 'consumer_installment_loan' | 'consumer_bnpl' | 'consumer_revolving_line_of_credit' | 'consumer_closed_line_of_credit' | 'consumer_secured_installment_loan' | 'consumer_secured_revolving_line_of_credit' | 'commercial_installment_loan' | 'commercial_revolving_line_of_credit' | 'commercial_closed_line_of_credit' | 'commercial_bnpl' | 'commercial_merchant_advance', required
  - `requested_amount` integer, nullable: If the borrower requests an amount in their application, the requested loan or credit line amount (in cents).
  - `third_party_disbursement_destination` string, nullable: For credit applications of type `consumer/commercial_bnpl`, the third party (i.e. merchant - "Acme Co.") is the person receiving the funds

## Response `200`

- Application
  - `id` string
  - `borrower_id` string
  - `created_on` string, date-time, nullable: Timestamp the application object is created on
  - `credit_type` 'consumer_installment_loan' | 'consumer_bnpl' | 'consumer_revolving_line_of_credit' | 'consumer_closed_line_of_credit' | 'consumer_secured_installment_loan' | 'consumer_secured_revolving_line_of_credit' | 'commercial_installment_loan' | 'commercial_revolving_line_of_credit' | 'commercial_closed_line_of_credit' | 'commercial_bnpl' | 'commercial_merchant_advance'
  - `decisioned_on` string, date-time, nullable: Timestamp when the application is either approved or rejected on
  - `offers` Offer[], nullable: If the application is approved, an object containing the credit offer details
    - union
      - object
        - `type` 'revolving_line_of_credit_offer', required
        - `id` string, required
        - `amount` integer, required: The amount (in cents) of the credit line offer (e.g. '200000' for $2,000.00)
        - `apr` integer, nullable: The annual percentage rate (in basis points) of the credit line
        - `annual_fee` integer, nullable: The annual fee charged for the credit line (e.g. '5000' for $50.00)
        - `billing_cycle` integer, nullable: The time in days between the last statement's closing date and the next statement's closing date. For consumer lines of credit, the minimum is '21'
        - `finance_charge` integer, nullable: If your platform charges a monthly finance charge for access to the line, the amount in cents
        - `grace_period` GracePeriod
          - `term` integer, nullable: The time in days between the end of a billing cycle and the bill's due date. For consumer lines of credit, the minimum is '21'
          - `interest_rate` integer, nullable: The interest rate (in basis points) charged during the grace period. Must be '0' for consumer lines of credit. Defaults to 0 if omitted
        - `introductory_promo_period` IntroductoryPromoPeriod
          - `interest_rate` integer, required: The interest rate (in basis points) charged during the introductory period
          - `promo_term` PromoTerm, required
            - `term` integer, required: The term of the promotional period relative to the `term_type` (e.g. if `daily` in days, `period` in period of loan, etc.)
            - `term_type` 'daily' | 'period', required
        - `interest_rate` integer, nullable: The interest rate (in basis points) of the loan or credit line offer (e.g. '750' for 7.50%)
        - `late_payment_fee` integer, nullable: The fee charged if a borrower misses the payment due date, in cents (e.g. '2500' for $25.00; default to 0)
        - `minimum_payment` MinimumPayment
          - `type` 'interest_plus_percentage_of_principal', required
          - `value` integer, required: The minimum payment percentage due each billing cycle (e.g. 500 for 5.00%)
          - `floor` integer, nullable: The minimum payment floor in cents (e.g. 1500 for $15.00). Defaults to 1500 if omitted. If the percentage of the principal balance is less than the floor, the floor is used.
        - `payment_period` 'weekly' | 'biweekly' | 'monthly' | 'semi_monthly_first_15th' | 'semi_monthly_last_15th' | 'semi_monthly'
        - `first_payment_date` string, nullable: The date of the first payment, in ISO 8601 format (e.g. 2022-12-31)
      - object
        - `type` 'loan_offer', required
        - `id` string, required
        - `amount` integer, required: The amount (in cents) of the loan offer (e.g. 200000 for $2,000.00)
        - `grace_period` GracePeriod
          - `term` integer, nullable: The time in days between the end of a billing cycle and the bill's due date. For consumer lines of credit, the minimum is '21'
          - `interest_rate` integer, nullable: The interest rate (in basis points) charged during the grace period. Must be '0' for consumer lines of credit. Defaults to 0 if omitted
        - `introductory_promo_period` IntroductoryPromoPeriod
          - `interest_rate` integer, required: The interest rate (in basis points) charged during the introductory period
          - `promo_term` PromoTerm, required
            - `term` integer, required: The term of the promotional period relative to the `term_type` (e.g. if `daily` in days, `period` in period of loan, etc.)
            - `term_type` 'daily' | 'period', required
        - `interest_rate` integer, nullable: The interest rate (in basis points) charged on the loan principal (e.g. 750 for 7.50%)
        - `origination_fee` OriginationFee
          - `type` 'deducted' | 'capitalized', required
          - `fee` integer, required: The origination fee in bps
        - `payment_period` 'weekly' | 'biweekly' | 'monthly' | 'semi_monthly_first_15th' | 'semi_monthly_last_15th' | 'semi_monthly'
        - `first_payment_date` string, nullable: The date of the first payment, in ISO 8601 format (e.g. 2022-12-31)
        - `late_payment_fee` integer, nullable: The fee charged if a borrower misses the payment due date, in cents (e.g. 2500 for $25.00)
        - `loan_term` Term, required
          - `term_type` 'months' | 'days' | 'payments', required
          - `term` integer, required: The term of the loan according to the term type. A minimum of 3 is required for monthly payment_period, 6 for semi-monthly, 7 for biweekly and 13 for weekly.
        - `security_amount` integer, nullable: The amount (in cents) of the value of the loan collateral (e.g. 200000 for $2,000.00). Required for secured loan application types.
      - object
        - `type` 'merchant_advance_offer', required
        - `id` string, required
        - `apr` integer, nullable: The annual percentage rate (in basis points) of the credit line
        - `amount` integer, required: The amount (in cents) of the loan offer (e.g. 200000 for $2,000.00)
        - `interest_rate` integer, required: The interest rate charged on the advance
        - `loan_term` Term, required
          - `term_type` 'months' | 'days' | 'payments', required
          - `term` integer, required: The term of the loan according to the term type. A minimum of 3 is required for monthly payment_period, 6 for semi-monthly, 7 for biweekly and 13 for weekly.
        - `origination_fee` OriginationFee
          - `type` 'deducted' | 'capitalized', required
          - `fee` integer, required: The origination fee in bps
        - `late_payment_fee` integer, nullable: The fee charged if a borrower misses the payment due date, in cents (e.g. 2500 for $25.00)
  - `rejection_reasons` RejectionReason[], nullable: If the application is rejected, a list containing 1-4 rejection reason(s). The Rejection Reasons endpoint provides a list of valid reasons and descriptors
  - `requested_amount` integer, nullable: If the borrower requests an amount in their application, the requested loan or credit line amount in cents (e.g. 500000 for $5,000)
  - `status` 'pending' | 'approved' | 'accepted' | 'declined' | 'incomplete' | 'rejected', required
  - `third_party_disbursement_destination` string, nullable: For credit applications of type `consumer_bnpl`, the third party (i.e. merchant) receiving the funds is specified here
  - `lender_of_record` string, nullable: The lender of record
  - `credit_data` CreditData
    - `fico` integer, nullable: A FICO score (e.g. 750)
    - `has_bankruptcy_history` boolean, nullable: Whether or not there is bankruptcy history

## Other responses

- `400`
- `401`
- `404`
- `429`
- `500`

---

[API](https://skmtc.dev/pier-finance/apis/pier-api.md) - [All operations](https://skmtc.dev/pier-finance/apis/pier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pier-finance/apis/pier-api/revisions/08a7c49252b9?raw)