Skip to Content
HelvetlyDocs
API referenceProducts

Export products as CSV

Needs a token with the read:products scope (or write:products). Authentication

Try in Playground sends a real request to app.helvetly.com with a token you paste. It stays in this browser tab only (session storage) and goes to no one else.

GET
/api/v1/products/export

Downloads the items matching the filters (as list_products, plus ids) as a UTF-8 CSV with a BOM: type, name, sku, gtin, unit, price_basis, unit_price, unit_price_net, unit_price_gross, currency, vat_category, vat_rate, status (active or archived), description, created_at, updated_at. Not paged. Read-only; safe to retry.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A personal API token, hvt_…, with scopes such as read:* or write:invoices

Query Parameters

search?string

Matches name, SKU and description.

type?string

Products or services.

Value in"product""service"
status?string

Active or archived. Ignored when ids is set.

Default"active"
Value in"active""archived"
currency?string

Comma-separated ISO codes.

ids?string

Comma-separated item ids: export only these.

sort?string

One of name, sku, unit_price, created_at, updated_at; prefix - for descending. Default name.

Response Body

A CSV file (UTF-8).

response?filetext/csv
Formatbinary
Example Request
curl -X GET 'https://app.helvetly.com/api/v1/products/export'
Example Response
"string"