documents

Get document metadata

Retrieve metadata for a single document. The caller must be authorized for the vehicle the document is tagged to. Executed investment documents and financial-statement workbooks (via the document_id on listFinancialStatements rows) are addressable; other documents return 404.

get/v1/documents/{document_id}

Request

  • Base URL
    https://api.angellist.com
  • Auth
    OAuth 2
    Authorization code: https://gateway.angellist.com/oauth/authorize
    Client credentials
    Token URL: https://gateway.angellist.com/oauth/token scopes: documents:read

Path parameters

document_idstring required

Public document ID (a doc_ id, e.g. from searchDocuments or the document_id on listFinancialStatements rows).

Response

The document.

content_typestring

MIME type.

createdinteger required

Creation time, unix seconds.

idstring required
livemodeboolean required
namestring required

Original file name.

object'document' required
sizeinteger

File size in bytes.

typestring

Document category (snake_case). One of a fixed set: stock_purchase_agreement, convertible_equity_agreement, safe, note, warrant, agreement_for_future_tokens, token_purchase_agreement, token_warrant, token_warrant_purchase_agreement, token_warrant_exercise_notice, financial_statements. Search results only contain executed investment documents; financial_statements appears only when following a document_id from listFinancialStatements through getDocument.

Example response

{
  "content_type": "application/pdf",
  "id": "doc_a1b2c3d4e5f6g7h8",
  "name": "Subscription Agreement - Acme Fund I.pdf",
  "presigned_url": {
    "expires_at": 1717171717,
    "url": "https://files.example.com/doc.pdf?signature=..."
  },
  "size": 245678,
  "type": "stock_purchase_agreement",
  "vehicle": {
    "id": "vhcl_k9Rm3nQp8wL1YxTa"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.