Skip to main content
Files are binary or text artifacts produced by Syntage resources, such as PDFs, XML files, CSV exports, and generated reports. Most file records are returned from another resource first. For example, an invoice, tax return, export, background check, or company verification report may include one or more files. Use the file endpoint when you need the file metadata, and use the download endpoint when you need the actual file content. The download response content type depends on the stored file. Common formats include PDF, XML, CSV, XLSX, JSON, and plain text.
Use the file metadata to inspect the file type, name, size, and related resource before downloading the content.

​
How Files Are Used

  1. Get a resource that references a file, such as an invoice, export, tax return, report, or background check.
  2. Store the file ID or file IRI if your integration needs to retrieve the file later.
  3. Retrieve the file when you need metadata such as filename, media type, size, or related resource.
  4. Use the download endpoint when you need the file content.

​
Example File

{
  "@id": "/files/91106968-1abd-4d64-85c1-4e73d96fb997",
  "@type": "File",
  "id": "91106968-1abd-4d64-85c1-4e73d96fb997",
  "type": "invoice.cfdi.xml",
  "resource": "/invoices/7c45e9c6-8f7f-4d0e-b6e5-65fef6c8c2f9",
  "mimeType": "text/xml",
  "extension": "xml",
  "size": 40544,
  "filename": "6f3c5312-2849-4525-86f6-c48a54c64c60.xml",
  "createdAt": "2026-06-16T14:30:00.000Z",
  "updatedAt": "2026-06-16T14:30:00.000Z"
}