api.rnda.io

API Reference

The RNDA API is a REST API served over HTTPS. All endpoints require a Bearer token. To request API access, contact us.

BASE URL
https://api.rnda.io

Authentication

All requests require a Bearer token in the Authorization header. API keys are issued per enterprise client after POC evaluation.

Authorization: Bearer YOUR_API_KEY

Endpoints

POST/api/encode

Encode a single record to a 256-byte signature. Raw data is permanently discarded after encoding.

REQUEST BODY
{
  "text": "your input data here",
  "context": "general"
}
RESPONSE
{
  "signature_id": "sig_abc123",
  "encoder_version": "v1.0",
  "encoded": true,
  "raw_data_retained": false
}

Supports text, structured data, and base64-encoded binary data.

CURL EXAMPLE
curl -X POST https://api.rnda.io/api/encode \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '"text": "your input data here",'
POST/api/encode/batch

Encode multiple records in a single request. Optimized for bulk ingestion workloads.

REQUEST BODY
{
  "records": [
    { "text": "first record", "label": "record_001" },
    { "text": "second record", "label": "record_002" }
  ]
}
RESPONSE
{
  "encoded": 2,
  "failed": 0,
  "signature_ids": ["sig_abc123", "sig_def456"]
}

Up to 100 records per batch request.

CURL EXAMPLE
curl -X POST https://api.rnda.io/api/encode/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '"records": ['
POST/api/query

Query the signature store for semantically similar records. Returns reconstructed outputs — never raw data.

REQUEST BODY
{
  "query": "your search query",
  "contexts": ["executive", "academic", "general"],
  "top_k": 5
}
RESPONSE
{
  "reconstructions": [
    {
      "context": "executive",
      "output": "Reconstructed contextual output...",
      "top_match": "sig_abc123",
      "top_similarity": 0.847
    }
  ],
  "query_latency_ms": 22
}

Queries return reconstructed semantic outputs, not stored data. The same signatures produce different outputs for different contexts.

CURL EXAMPLE
curl -X POST https://api.rnda.io/api/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '"query": "your search query",'
POST/api/query/binary

Submit a binary file (image, audio, DNA sequence, LiDAR scan) and find the most similar signatures in the store.

REQUEST BODY
{
  "data": "<base64-encoded binary>",
  "data_type": "image",
  "top_k": 10
}
RESPONSE
{
  "matches": [
    { "signature_id": "sig_abc123", "similarity": 0.924, "label": "record_001" },
    { "signature_id": "sig_def456", "similarity": 0.871, "label": "record_002" }
  ],
  "query_latency_ms": 35
}

Supported data types: image, audio, dna, lidar, video, molecular, seismic, timeseries, graph, code, financial, av.

CURL EXAMPLE
curl -X POST https://api.rnda.io/api/query/binary \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '"data": "<base64-encoded binary>",'
GET/api/health

Check API status, current configuration, and signature store statistics.

RESPONSE
{
  "status": "healthy",
  "config": "image",
  "signatures_stored": 20000,
  "index_latency_ms": 1.2,
  "encoder_version": "v1.0"
}

No authentication required for health checks.

Rate Limits

POC Evaluation
Scoped to your domain and dataset. Issued after intake call.
Enterprise
Custom limits, dedicated instance, SLA. Contact us to discuss.

Request API Access

API keys are issued after enterprise POC evaluation. Tell us about your use case and data type.

Request Access →