For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Middesk API
        • Action
        • Address
        • Adverse Media Screening
        • Bankruptcy
        • Business
        • Certification
        • Document
        • Formation
        • Industry Classification
        • Lien
        • Litigation
        • Monitor
        • Names
        • Order
        • Person
        • Policy Result
        • Politically Exposed Persons Screening
        • Registration
        • Review Task
        • Signal
        • Tax exempt organization
        • TIN
        • Watchlist
        • Website
        • Profile
LogoLogo
Contact SalesGet Support
On this page
  • Document attributes
Middesk APIBusiness VerificationObject reference

Document object

Was this page helpful?
Previous

Formation object

Next
Built with

This page describes the document object, which provides downloadable business filing documents (like Articles of Incorporation and Certificates of Good Standing) retrieved directly from government sources, eliminating the need for manual document collection.

In retrieving filings directly from the source, Middesk also provides the ability to download documents related to these filings. Often, retrieving these documents can supersede the process of reaching out to an individual and requesting upload through a document capture flow.

Example JSON response
1{
2 "object": "document",
3 "id": "1538c2f9-ff0f-489e-0099-a5f116a4af07",
4 "document_type": "Initial_Filing",
5 "filename": "3868812_Articles_Of_Incorporation_2009-03-16",
6 "content_type": "application/pdf",
7 "size": 82034,
8 "download_url": "https://storage.middesk.com/middesk/z6q1p5209ipr0vgof1900l1s580n",
9 "created_at": "2020-04-30T23:50:51.222Z",
10 "source": {
11 "type": "registration",
12 "id": "2b16130a-0351-49fc-9f73-4a8a1ccc95c8",
13 "metadata": {
14 "state": "PA",
15 "status": "active"
16 }
17 },
18 "filing_date": "2009-03-16T00:00:00.000Z"
19}

Document attributes

AttributeTypeDescription
objectstringThe object type. Always document.
idstring (uuid)The unique identifier for the document record.
document_typestringThe type of document. For SOS documents, Articles of Incorporation are Initial_Filing and Certificates of Good Standing are Certificate of Good Standing. UCC1 documents are Initial Filing.
filenamestringThe filename for the document.
content_typestringThe media type for the document, like application/pdf.
sizeintegerThe size in bytes of the document.
download_urlstringURL for downloading the document contents.
created_attimestampThe time the document was retrieved for the Business.
sourceobjectThe source for the document. In many cases, these are a link to a Registration record.
source.typestringThe source type (for example, registration).
source.idstring (uuid)The ID of the source record.
source.metadataobjectAdditional source metadata.
filing_datetimestamp | nullThe date the document was filed.
metadataobjectAdditional document metadata.
Get a demo
Contact your account manager or contact sales to inquire about access.