OriginFold Docs
Website ↗
01 / THE SAME REQUEST

One small page.
Two ways to ask.

The examples below use illustrative synthetic data. fixture.metrics is a test dataset, not a public offering. For your account, copy a complete request from the Explorer or replace the dataset, version, fields, identifiers and dates with values from your authenticated catalogue.

ONE BOUNDED PAGEHTTP
curl --fail-with-body --get "$ORIGINFOLD_API_URL/v1/data/fixture.metrics" \
  --header "Authorization: Bearer $ORIGINFOLD_API_KEY" \
  --data-urlencode "dataset_version=00000000-0000-7000-8000-000000000010" \
  --data-urlencode "fields=series_id,value" \
  --data-urlencode "entity_id=s" \
  --data-urlencode "start=2026-01-01" \
  --data-urlencode "end=2026-09-01" \
  --data-urlencode "as_of=2026-09-01T12:00:00+00:00" \
  --data-urlencode "limit=25"
THE EQUIVALENT PAGEPYTHON
from datetime import UTC, date, datetime
from uuid import UUID
from originfold_sdk import Client, Query

query = Query(
    dataset_id="fixture.metrics",
    dataset_version=UUID("00000000-0000-7000-8000-000000000010"),
    fields=("series_id", "value"),
    entity_ids=("s",),
    start=date(2026, 1, 1),
    end=date(2026, 9, 1),
    as_of=datetime(2026, 9, 1, 12, tzinfo=UTC),
    limit=25,
)
with Client.from_env() as client:
    page = client.query(query)
    print(page.data)
    print(page.request_id)
    print(page.usage["remaining"])

start and end are inclusive source-domain dates. as_of is a separate UTC availability cutoff. Use repeated entity_id parameters for up to 100 exact identifiers; the Python equivalent is a tuple of identifiers. Entity IDs are not free-text company names. Select distinct supported fields and a short range within your Plan's history.

Python inputs use date, UTC datetime and UUID. Returned decimal JSON numbers use Decimal; integers remain integers. Dataset date fields remain their documented JSON strings. Interpret each field before converting it.