---
title: "Create pre-approval request"
method: POST
path: "/api/public/v1/pre_approvals"
tags: ["Pre-Approvals"]
---

# Create pre-approval request

`POST /api/public/v1/pre_approvals`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/public/v1/pre_approvals`
- Auth: HTTP basic

Create a pre-approval request for a shopper to check their credit eligibility

## Headers

- `Authorization` string, required

## Request body

- PublicCreatePreApproval
  - `merchant` object, required
    - `reference` string, required
    - `store_ref` string, required
  - `shopper` object, required
    - `given_names` string, required
    - `surnames` string, required
    - `nin` string, required
    - `email` string, required
    - `mobile_phone` string, required
    - `postal_code` string
    - `date_of_birth` string

## Response `201`

successful

- PublicPreApprovalResponse
  - `approved` boolean, required
  - `amount_limit` PrintableCurrency
    - `value` integer, required
    - `string` string, required
  - `traffic_light_status` string, nullable
  - `fields_completed` integer, nullable
  - `fields_total` integer, nullable
  - `missing_optional_fields` unknown[], nullable
    - unknown
  - `approved_amount` integer, nullable
  - `show_approved_amount` boolean, nullable

## Other responses

- `401`: unauthorized
- `422`: unprocessable entity

---

[API](https://skmtc.dev/sequra/apis/instore-api.md) - [All operations](https://skmtc.dev/sequra/apis/instore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequra/apis/instore-api/revisions/29430b803abc?raw)