---
title: "Import executed SAFEs"
method: POST
path: "/safes/imports"
tags: ["safe"]
---

# Import executed SAFEs

`POST /safes/imports`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/safes/imports`
- Auth: HTTP bearer

Adds SAFEs signed elsewhere as Executed, each with its uploaded PDF kept as it came and its SHA-256, into round_id or, without it, "Before Binderwork". A DocuSign certificate for the same envelope gives the signing time; else signed_on does. Each gets an Unconfirmed register entry for an officer to confirm. A file imported before is refused.

## Request body

- object
  - `round_id` string, nullable
  - `safes` object[], required
    - `document_id` string, required
    - `certificate_document_id` string, nullable
    - `investor` string, required
    - `email` string, email, required
    - `amount` union, required
      - number
      - string
    - `form` 'cap' | 'discount' | 'mfn', required
    - `cap` union
      - number
      - string
    - `discount_percent` number, nullable
    - `date_of_safe` string, date, required
    - `signed_on` string, date, nullable
    - `country` string: ISO 3166-1 alpha-2
    - `read_by_ai` object, nullable
      - `model` string, required

## Response `200`

The result.

- object
  - `round_id` string, required
  - `safes` object[], required
    - `safe_id` string, required
    - `investor` string, required
    - `amount` string, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)