<!-- https://staircase.co/data/property/file -->
# file

# file

Media and documents associated with a property: images, recorded documents, and their source references.

<!--source:property-registry-->
The file class is a comprehensive data structure that represents all media and documents associated with a specific property, including images, PDFs, and floor plans across multiple file formats (JPEG, PNG, PDF).
<!--/source-->

The question it answers

## What changed since it was built?

Two physically identical houses on the same street diverge by six figures if one had a gut renovation. Photographs show current condition but not cost basis, scope, or recency. A permit records all three, and a pulled but unfinalised permit is a leading indicator priced differently again. Permits are issued by municipalities rather than counties, which is an order of magnitude more integration surface than parcel data and the reason incumbent coverage is thin.

Other classes answering this question

## Why it matters

Documents are how a claim is verified. A deed record links to the recorded instrument; a permit links to the filing; a photograph is dated evidence of condition. The class carries the reference rather than the bytes, so the record stays small and the source stays authoritative.

## In practice

Each entry carries the source reference it was retrieved by, which for county clerk documents is a document number resolvable against the clerk's own index. That is what allows a document cited here to be re-fetched independently rather than taken on trust.

## Properties

| Property | Type | Definition |
| --- | --- | --- |
| `source_http_request` | `object | null` | <!--source:property-registry-->HTTP request configuration for retrieving this data.<!--/source--> |
| `request_identifier` | `string | null` | <!--source:property-registry-->Identifier value that should be substituted into the source HTTP request to retrieve this specific data.<!--/source--> |
| `file_format` | `string | null` | <!--source:property-registry-->The format or MIME type of the file. `jpeg``png``txt`<!--/source--> |
| `name` | `string | null` | <!--source:property-registry-->A human-friendly name for the media asset.<!--/source--> |
| `original_url` | `string | null` | <!--source:property-registry-->HTTP/HTTPS source URL of the media asset.<!--/source--> |
| `document_type` | `string | null` | <!--source:property-registry-->Semantic role or classification of the document. `Title``ConveyanceDeedQuitClaimDeed``ConveyanceDeedBargainAndSaleDeed``ConveyanceDeedWarrantyDeed``ConveyanceDeed``AssignmentAssignmentOfDeedOfTrust``AssignmentAssignmentOfMortgage``AssignmentAssignmentOfRents``Assignment``AssignmentAssignmentOfTrade``AssignmentBlanketAssignment``AssignmentCooperativeAssignmentOfProprietaryLease``AffidavitOfDeath``AbstractOfJudgment``AttorneyInFactAffidavit``ArticlesOfIncorporation``BuildingPermit``ComplianceInspectionReport``ConditionalCommitment``CounselingCertification``AirportNoisePollutionAgreement``BreachNotice``BrokerPriceOpinion``AmendatoryClause``AssuranceOfCompletion``Bid``BuildersCertificationBuilderCertificationOfPlansAndSpecifications``BuildersCertificationBuildersCertificate``BuildersCertificationPropertyInspection``BuildersCertificationTermiteTreatment``PropertyImage`<!--/source--> |

## Provenance and coverage

A record of this class is validated against the same definition whatever jurisdiction it came from, which is what makes two counties comparable without a per-county adapter. A jurisdiction appears below only where a committed configuration serves this class's surface.

- Santa Clara, California

How a new jurisdiction is brought online
