Programmatic access to eDNA analysis

Oceara API

Integrate no-code eDNA metabarcoding analysis into your applications and workflows. Build species detection, biodiversity monitoring, and conservation reporting directly into your software.

RESTful API

Standard REST endpoints for submitting samples, monitoring analysis progress, and retrieving species detection results. JSON request and response formats for seamless integration with modern applications.

Authentication

OAuth 2.0 and API key authentication for secure access control. Support for service accounts, user tokens, and fine-grained API permissions for enterprise deployments.

Webhooks

Real-time event notifications for sample processing milestones. Get notified when analysis completes, quality control passes, or results are ready—enabling event-driven workflows.

SDKs

Official Python and R packages for direct integration into data science workflows. Simplify sample submission, status checking, and result retrieval with native library bindings.

API Integration Example

Here's how simple it is to integrate Oceara eDNA analysis into your application using our REST API. Submit samples, check processing status, and retrieve biodiversity results programmatically.

1. Upload Sample

POST /api/v1/samples
Content-Type: application/json

{
  "name": "Puget Sound Zone 3",
  "location": "Puget Sound, WA",
  "file_url": "s3://your-bucket/sample.fastq",
  "primers": ["12S", "COI"],
  "reference_database": "NCBI"
}

// Response
{
  "sample_id": "s_7f2k9m1n",
  "status": "queued",
  "created_at": "2024-02-03T14:32:10Z"
}
            

2. Check Processing Status

GET /api/v1/samples/s_7f2k9m1n

// Response
{
  "sample_id": "s_7f2k9m1n",
  "status": "processing",
  "progress": 65,
  "current_step": "Taxonomic assignment",
  "estimated_completion": "2024-02-03T15:15:00Z"
}
            

3. Retrieve Results

GET /api/v1/samples/s_7f2k9m1n/results

// Response
{
  "sample_id": "s_7f2k9m1n",
  "status": "complete",
  "species_detected": 248,
  "read_depth": "36.2M",
  "confidence": "High",
  "species": [
    {
      "name": "Oncorhynchus kisutch",
      "common_name": "Coho salmon",
      "confidence": 0.98,
      "read_count": 4250
    },
    {
      "name": "Oncorhynchus tshawytscha",
      "common_name": "Chinook salmon",
      "confidence": 0.95,
      "read_count": 3821
    }
  ],
  "report_url": "https://oceara.io/reports/r_9k3p2l7q"
}
            