Skip to main content
GET
Node.js

Authorizations

Authorization
string
header
required

A secret API key, made under Developers in the dashboard: Authorization: Bearer shoply_sk_...

Path Parameters

storeId
string
required

The store's ID. A key reaches the store it was made in: GET /key answers which.

Query Parameters

Part of an email address.

sort
enum<string>
default:newest

What the file is ordered by, largest or latest first.

Available options:
newest,
spent,
orders,
recent,
balance
only
enum<string>

Only customers who are affiliates, or who are subscribed to the store's news and offers.

Available options:
affiliates,
subscribed
tag
string

Only customers wearing this tag: vip, disputed, or the ID of one of the store's own.

check
enum<string>

1 for how many rows the file would have, as { rows }, in place of the file. Not counted against the store's exports, and refused with 429 where none are left.

Available options:
1
range
enum<string>

Only customers first seen in this period.

Available options:
today,
yesterday,
7d,
30d,
this_week,
last_week,
this_month,
last_month,
this_year
from
string

Only customers first seen on or after this day, as YYYY-MM-DD. With to, in place of range.

to
string

Only customers first seen on or before this day, as YYYY-MM-DD.

tz
string

The time zone those days are in, as an IANA name. Left out, UTC.

Example:

"Europe/Berlin"

Response

The file itself, not a JSON envelope.

The response is of type file.