Skip to main content
The SOLO Network supports bulk data ingestion via SFTP. Upload CSV or JSONL files to your designated SFTP endpoint, and the data is automatically processed and made available through the network.

​
Connecting

Connect to the SFTP server using any standard SFTP client: 
sftp -P 22 your-username@sftp.solo.one
Or using an SFTP library: 
import paramiko

transport = paramiko.Transport(("sftp.solo.one", 22))
transport.connect(username="your-username", password="your-password")
sftp = paramiko.SFTPClient.from_transport(transport)

sftp.put("local-file.csv", "/federations/{stakeholder_id}/identity_prefill/uploaded/data.csv")

sftp.close()
transport.close()
Your SFTP credentials and stakeholder ID are provided by your SOLO account manager. Contact support if you need access provisioned.

​
Upload Path

Files must be uploaded to schema-specific directories following this pattern: 
federations/{stakeholder_id}/{schema}/uploaded/{filename}.csv
For example: 
federations/abc123/identity_prefill/uploaded/batch-2024-01.csv
federations/abc123/address_verification/uploaded/addresses.csv
federations/abc123/consumer/uploaded/consumers.csv
The {schema} determines which template the data maps to. See Available Schemas for the full list.

​
How It Works

  1. Upload your CSV or JSONL file to the appropriate schema directory via SFTP
  2. Processing begins automatically — each row is validated and ingested independently
  3. Data becomes available for querying through the corresponding template endpoints
Key behaviors:
  • Row-level processing — Each row is handled independently. A single invalid row does not affect the rest of the file.
  • Duplicate detection — Re-uploading the same file is safely ignored.
  • Error reporting — Failed rows are flagged for review. Contact your account manager for access to error reports.

​
File Requirements

  • Formats: CSV (.csv) or JSON Lines (.jsonl)
  • Encoding: UTF-8
  • Headers: First row must contain column headers matching field names exactly
See CSV Format for detailed formatting requirements.