Skip to main content

Developer Documentation

Welcome to the developer's space for exploring Filedgr's Data Attestation Platform. Here you'll find everything you need to build, integrate, and extend with Filedgr's APIs and SDKs.

Our Mission​

Empower organizations to own, manage and benefit from their data safely.

👉 Check out What is Filedgr & Why it matters to learn more about our mission and business context.

What is the Data Attestation Platform?​

The Filedgr Data Attestation Platform is an enterprise-grade framework to turn files, assets, and processes into verifiable digital records.

You can use the platform in two ways:

  • Web Interface → manage templates, vaults, and digital twins without writing code
  • APIs & SDKs → integrate attestation, verification, and secure data sharing directly into your own systems and workflows

The platform is built for enterprise use and designed to support regulatory requirements such as GDPR and CSRD.

Core Developer Features​

With Filedgr, you can build:

  • Templates → Define the streams every vault starts with, plus its default imagery
  • Vaults → Token-backed containers for your data
  • Data Streams → Named channels inside a vault that your data attaches to
  • Signatures → Bind a wallet to a file hash and anchor it on-chain
  • Proof Packages → Time-boxed, download-limited evidence bundles for auditors
  • Explorer → Publish a vault so anyone can verify it, with no account

Developer Experience​

Filedgr supports both custodial and non-custodial usage patterns:

Managed Wallets (Custodial)​

Accounts provisioned through the web app get a managed wallet, so you never handle private keys.

note

Creating vaults, streams and data attachments requires an ETHEREUM WALLET credential on the key holder — this holds even for vaults on the XRPL ledger. If it is absent the API returns 422 MissingWalletCredentialError. Complete wallet setup in the web app before using the API.

External Wallets (Non-Custodial)​

Advanced users can connect their own wallets and sign transactions directly. Ideal for production-grade integrations where maximum control and decentralization are required.

Integration Capabilities​

Filedgr is designed for real-world integrations:

  • Authentication & Access Control → API key and secret headers, with role-based vault, stream and asset permissions (OWNER, ADMIN, EDITOR, VIEWER, CUSTOM)
  • Automated Compliance → Generate immutable audit trails and reports on demand
  • Multi-Chain Flexibility → Support for Polygon, Ethereum, XRPL, and other networks
  • Integration-First Design → REST API and webhooks, callable from any language
  • Plug into workflows → ERP, CRM, supply chain, oracles, and no-code platforms

Quick Start Options​

🚀 5-Minute Quickstart

Get up and running with your first API call in under 5 minutes.

Start Building

🔑 Authentication

Learn about API keys and the two headers every request carries.

Setup Auth

📚 API Reference

Complete documentation for all endpoints, parameters, and responses.

Browse APIs

📦 SDKs

Pre-built libraries for JavaScript, Python, Go, and more coming soon.

Get SDKs

Platform Architecture​

REST APIs​

Full platform functionality accessible via HTTP requests:

  • Create and manage vaults programmatically
  • Upload and verify data through API calls
  • Control permissions for users and applications
  • Generate verification proofs for third parties
  • Monitor activity with detailed audit logs

Webhooks​

Real-time notifications for important events:

  • Data updates in vaults and streams
  • Permission changes for access control
  • Verification completions for uploaded data
  • Compliance alerts for regulatory requirements

Smart Contract Integration​

Direct blockchain interaction for advanced use cases:

  • Custom vault logic with your own smart contracts
  • Multi-chain deployments across different networks
  • Automated workflows triggered by blockchain events
  • Integration with DeFi and other Web3 protocols

Supply chain transparency​

Create a vault per batch from a supply-chain template, then attach a document at each hand-off — manufacture, inspection, customs, delivery. Each attachment is hashed and anchored, so a buyer can verify the chain without trusting the seller.

Certificates and compliance records​

Notarize certificates as they are issued. The file hash and its anchoring transaction are enough for a third party to confirm the document has not changed since issuance.

Verifiable audit trails​

Give an auditor a proof package — a time-boxed, download- limited bundle covering the files in scope — instead of granting standing access to your vault.

Development environments​

Filedgr runs as a managed service, so there is no local stack to install. Point your integration at a non-production host and use credentials issued for that environment:

EnvironmentBase URL
Productionhttps://api.filedgr.network
Testhttps://api.test.filedgr.network
Developmenthttps://api.dev.filedgr.network

Credentials are per-environment and are not interchangeable. Blockchain operations on the non-production hosts run against test networks, so they cost no real gas — they still consume Filedgr credits.

Getting help​

Next Steps​

Ready to start building? Choose your path:

  1. Quick Start Guide - Get your API key and make your first call
  2. Authentication - The two headers every request carries
  3. Core Concepts - Understand vaults, templates and streams
  4. API Reference - Explore all available endpoints

The platform​

The power of blockchain verification, made simple for developers.