REST API
Read your in-market accounts and report outcomes back from your own tools with a scoped key.
The REST API lets your own tools read your Vergio account and report outcomes back. Every read is scoped to your workspace, so you only ever see your own accounts.
Get started
Create a key. In your workspace, go to Integrations and create a key with the scopes you need. See API keys.
Call the API. Send the key as a Bearer token to https://vergio.ai/api/v1.
curl "https://vergio.ai/api/v1/lists/current" \
-H "Authorization: Bearer $VERGIO_API_KEY"What you can do
- Read this week's in-market list, with the evidence behind each account.
- Search and page through your scored accounts.
- Read one account's detail and its signal history.
- Report an outcome, which becomes a learning label that improves your rankings.
Full reference
The complete reference covers authentication, scopes, rate limits, errors, and every endpoint with copy ready samples in curl, TypeScript, and Python.
Updated July 6, 2026
Is this page helpful?