Developers › API reference › Data

POST /api/v1/data/{dataset}

Load a file (CSV, TXT, XLSX or Vestoris XML) into a data set; the body is the file.

• Scope data:load:<data set>
• Legacy keys
• operationId dataLoad

The token needs the scope data:load:<data set>, and the person or service account behind it needs the matching privileges and account permissions, exactly as on the screens. See Scopes.

Request

POST /api/v1/data/{dataset}

Path parameters

Query parameters

Headers

Body

The file itself, sent as the raw request body (not a form). Name it with the filename query parameter; the extension tells Vestoris the format. See the Data Feed Reference for the XML formats and the loading center for CSV columns.

Examples

Keep the token in an environment variable (VESTORIS_TOKEN), never in the script.

curl -X POST "https://vestoris.com/api/v1/data/prices?filename=prices.csv&mode=upsert&business_date=2026-10-27" \
  -H "Authorization: Bearer $VESTORIS_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @prices.csv

import os, requests

r = requests.post(
    "https://vestoris.com/api/v1/data/prices",
    headers={
        "Authorization": f"Bearer {os.environ['VESTORIS_TOKEN']}",
        "Content-Type": "application/octet-stream",
    },
    params={
        "filename": "prices.csv",
        "mode": "upsert",
        "business_date": "2026-10-27"
    },
    data=open("prices.csv", "rb"),
    timeout=30,
)
r.raise_for_status()  # errors are application/problem+json with a stable "code"
print(r.json())

import { readFile } from "node:fs/promises";

const res = await fetch("https://vestoris.com/api/v1/data/prices?filename=prices.csv&mode=upsert&business_date=2026-10-27", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VESTORIS_TOKEN}`,
    "Content-Type": "application/octet-stream",
  },
  body: await readFile("prices.csv"),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.code}: ${data.detail}`); // problem+json
console.log(data);

Response

201 Created, application/json: LegacyBatch. Rate-limit headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.

Example response

HTTP/1.1 201 Created
Content-Type: application/json

{
    "ok": true,
    "batch": {
        "id": 1,
        "dataset": "prices",
        "status": "active",
        "file_name": "ACME_PRICE_20261027_001.xml",
        "sha256": "e3b0…",
        "business_date": "2026-10-27",
        "counts": {
            "new": 3,
            "changed": 12,
            "unchanged": 580,
            "rejected": 1
        },
        "message": "",
        "hold_reason": null,
        "created_at": "2026-10-27T14:30:00Z",
        "applied_at": "2026-10-27T14:30:00Z"
    },
    "review": null
}

Example values. Your values depend on your firm's data; prices, orders and fills are simulated.

Status codes and errors

Errors are application/problem+json (RFC 9457) with a stable code to program against; the detail says what to fix. See Errors.

{
    "type": "https://vestoris.com/developers/errors#validation_failed",
    "title": "Validation failed",
    "status": 422,
    "detail": "Quantity must be greater than zero.",
    "code": "validation_failed",
    "instance": "/api/v1/data/prices"
}

On the screens

The same thing in the app is explained in:

• The loading center
• Templates and field dictionary
• Legacy API keys (deprecated)