Soria Data API

The Data API provides programmatic access to Soria’s governed customer data.

https://api.soriaanalytics.com/v1

Authentication

The Data API uses bearer API keys. Create and revoke them from the signed-in Soria data page; a new secret is shown once. Each key has the read:data permission: it may query, export, and retrieve the datasets available to that account, but it cannot modify Soria data or account settings.

curl "https://api.soriaanalytics.com/v1/catalog?query=enrollment" \
  --header "Authorization: Bearer $SORIA_API_KEY"

Keep keys in a secrets manager or server-side environment variable. For creation, expiration, revocation, OAuth, and error behavior, see Authentication.

Dataset discovery

The public documentation does not enumerate Soria’s catalog. After access is enabled, GET /catalog returns the datasets available on the governed customer surface. Use query and domain parameters to narrow the response. Prospective customers can request a catalog walkthrough.

Endpoints

Method	Path	Purpose
`GET`	`/`	Return links to the current API resources.
`GET`	`/health`	Read customer-data service readiness.
`GET`	`/catalog`	Search or list the customer catalog.
`GET`	`/catalog/{dataset}`	Get schema, grain, methodology, cadence, and recursive source lineage.
`GET`	`/catalog/{dataset}/metadata`	Get compact dataset metadata without columns or methodology.
`POST`	`/datasets/{dataset}/query`	Select, filter, sort, and page rows without arbitrary SQL.
`GET`	`/datasets/{dataset}/stats`	Count rows and optionally profile one column.
`GET`	`/datasets/{dataset}/files`	List contributing source files.
`GET`	`/datasets/{dataset}/files/{file_id}`	Get one verified source file as metadata plus parsed text or a short-lived original-file link.
`POST`	`/datasets/{dataset}/exports`	Queue a private CSV or Parquet export.
`GET`	`/exports/{export_id}`	Poll an export owned by the authenticated user.
`GET`	`/exports/{export_id}/download`	Redirect to a short-lived private export URL.
`POST`	`/search/documents`	Search the public source-document corpus.

Interactive endpoint schemas are also available at api.soriaanalytics.com/v1/docs.

Query a dataset

Replace the placeholders with a dataset and columns returned by the catalog:

curl --request POST \
  "https://api.soriaanalytics.com/v1/datasets/<dataset>/query" \
  --header "Authorization: Bearer $SORIA_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "columns": ["<column_1>", "<column_2>"],
    "filters": [
      {"column": "<column_1>", "operator": "eq", "value": "<value>"}
    ],
    "order_by": [{"column": "<column_2>", "direction": "desc"}],
    "limit": 100,
    "offset": 0
  }'

Filters are combined with AND. Supported operators are eq, ne, gt, gte, lt, lte, in, contains, and is_null. A page can contain up to 1,000 rows.

Exports

Exports reuse the same column, filter, and sort contract. They are private to the authenticated user, limited to CSV or Parquet, capped at 2 GB, and expire after 24 hours. Download links are signed for five minutes. For source-file behavior, see Provenance and source files.

Overview

MCP

Data API

Provenance

Data API

Soria Data API

Authentication

Dataset discovery

Endpoints

Query a dataset

Exports

​Soria Data API

​Authentication

​Dataset discovery

​Endpoints

​Query a dataset

​Exports

Soria Data API

Authentication

Dataset discovery

Endpoints

Query a dataset

Exports