---
title: "Read executed SAFEs for import"
method: POST
path: "/safes/imports/read"
tags: ["safe"]
---

# Read executed SAFEs for import

`POST /safes/imports/read`

## Request

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

Reads uploaded PDFs without a model: YC's post-money SAFE forms by their own words, with each value's place on the page and the places the file differs from YC's text; DocuSign's envelope stamp and certificate of completion, paired in the batch; anything else for a person to enter. Values are untrusted text from the file. A file imported before names its SAFE.

## Request body

- object
  - `document_ids` string[]
  - `upload_id` string

## Response `200`

The result.

- object
  - `files` object[], required
    - `document_id` string, required
    - `file_name` string, required
    - `sha256` string, required
    - `page_sizes` object[], required
      - `width` number, required
      - `height` number, required
    - `kind` 'yc_safe' | 'certificate' | 'other', required
    - `form` object, nullable, required
      - `key` 'cap' | 'discount' | 'mfn', required
      - `title` string, required
      - `version` string, required
      - `premoney` boolean, required
    - `values` object, required
      - `investor` string, nullable, required
      - `email` string, nullable, required
      - `company` string, nullable, required
      - `amount` string, nullable, required
      - `cap` string, nullable, required
      - `discount_percent` number, nullable, required
      - `date_of_safe` string, date, nullable, required
      - `state` string, nullable, required
      - `governing_law` string, nullable, required
    - `highlights` object[], required
      - `page` integer, required
      - `x` number, required
      - `y` number, required
      - `width` number, required
      - `height` number, required
      - `field` string, required
    - `difference_count` integer, required
    - `differences` object[], required
      - `expected` string, required
      - `found` string, required
    - `envelope_id` string, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `pairs_with` string, nullable, required
    - `facts` string[], required
    - `duplicate` object, nullable, required
      - `safe_id` string, required
      - `investor` 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)