---
updatedAt: 2026-04-21T04:46:34.000Z
agentTools:
  projectIndex: https://developer.alloy.com/public/llms.txt
---

# Get a List of All Documents for an Entity

All documents for an entity can be queried using this endpoint. All metadata for the documents is available, but the documents themselves must be downloaded individually.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Alloy API",
    "version": "1.0.0",
    "description": "hey hey hey, it's the Alloy API!"
  },
  "servers": [
    {
      "url": "https://sandbox.alloy.co/v1",
      "description": "Sandbox endpoint"
    }
  ],
  "security": [
    {
      "oauth2": []
    },
    {
      "basic": []
    }
  ],
  "tags": [
    {
      "name": "Documents",
      "description": "The document upload API is a two-step process. First, the metadata for the document is specified, and the API returns a file identifier so the file can be streamed directly to the next endpoint. You’ll need to look for the document_token returned in the response because that is necessary to pass to the next endpoint for streaming the file."
    }
  ],
  "paths": {
    "/entities/{entity_token}/documents": {
      "parameters": [
        {
          "in": "path",
          "name": "entity_token",
          "schema": {
            "type": "string"
          },
          "required": true,
          "description": "Token of entity for associated documents."
        }
      ],
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "Get a List of All Documents for an Entity",
        "description": "All documents for an entity can be queried using this endpoint. All metadata for the documents is available, but the documents themselves must be downloaded individually.",
        "responses": {
          "200": {
            "x-summary": "OK",
            "description": "Document",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Document"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "basic": {
        "type": "http",
        "description": "HTTP basic authorization using a workflow token and secret",
        "scheme": "basic"
      },
      "oauth2": {
        "type": "oauth2",
        "description": "Oauth2 using a workflow token and secret to generate a bearer token",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "/oauth/bearer",
            "scopes": {}
          }
        }
      }
    },
    "schemas": {
      "DocumentNotes": {
        "properties": {
          "note": {
            "type": "string"
          },
          "note_author_agent_email": {
            "type": "string"
          },
          "created_at": {
            "type": "number"
          },
          "updated_at": {
            "type": "number"
          }
        }
      },
      "Document": {
        "properties": {
          "document_token": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "contract",
              "license",
              "passport",
              "utility",
              "other",
              "internal",
              "identification_card",
              "residence_permit",
              "canada_provincial_id",
              "indigenous_card",
              "paystub",
              "bank_statement",
              "w2",
              "1099",
              "1120",
              "1065",
              "t1",
              "t4",
              "w9",
              "deposited_check",
              "voided_check",
              "social_security_card",
              "h1b",
              "passport_card",
              "credit_report",
              "iso_app",
              "brokerage_statement",
              "lease",
              "document",
              "ucc1",
              "incorporation_certificate",
              "good_standing_certificate"
            ]
          },
          "name": {
            "type": "string"
          },
          "extension": {
            "type": "string"
          },
          "uploaded": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "number"
          },
          "approved": {
            "type": "string"
          },
          "approval_agent_email": {
            "type": "string"
          },
          "approval_timestamp": {
            "type": "number"
          },
          "notes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DocumentNotes"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false
  }
}
```