Queek docs
Storefront endpoint reference

Addresses

GET
/store/addresses

Lists the signed-in customer’s saved addresses. A saved address belongs to the customer, never to one store.

Authorization

clientKey customerToken
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

AuthorizationBearer <token>

The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.

In: header

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/store/addresses" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Saved addresses retrieved",  "data": [    {      "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5ca1",      "label": "Home",      "address": "48 Greenwich Avenue, New York, NY 10011",      "lat": 40.7355,      "lng": -74.002,      "country_code": "US",      "state": "New York",      "city": "New York",      "area": "West Village",      "state_id": null,      "area_id": null,      "is_default": true    },    {      "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5ca2",      "label": "Office",      "address": "220 West 36th Street, New York, NY 10018",      "lat": 40.7527,      "lng": -73.9905,      "country_code": "US",      "state": "New York",      "city": "New York",      "area": "Midtown",      "state_id": null,      "area_id": null,      "is_default": false    }  ]}
POST
/store/addresses

Saves an address for the signed-in customer.

Authorization

clientKey customerToken
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

AuthorizationBearer <token>

The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.

In: header

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/store/addresses" \  -H "X-Client-Key: {{clientKey}}" \  -H "Content-Type: application/json" \  -d '{    "label": "Home",    "address": "48 Greenwich Avenue, New York, NY 10011",    "lat": 40.7355,    "lng": -74.002  }'
{  "status": "success",  "message": "Address saved",  "data": {    "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5ca1",    "label": "Home",    "address": "48 Greenwich Avenue, New York, NY 10011",    "lat": 40.7355,    "lng": -74.002,    "country_code": "US",    "state": "New York",    "city": "New York",    "area": "West Village",    "state_id": null,    "area_id": null,    "is_default": true  }}
DELETE
/store/addresses/{id}

Remove a saved address (Address removed). Deleting the default promotes the newest remaining address.

Authorization

clientKey customerToken
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

AuthorizationBearer <token>

The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.

In: header

Path Parameters

id*string

Id of the saved address, as returned by GET /store/addresses.

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/store/addresses/019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5ca2" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Address removed"}
PATCH
/store/addresses/{id}/default

Makes one of the customer’s saved addresses the default.

Authorization

clientKey customerToken
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

AuthorizationBearer <token>

The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.

In: header

Path Parameters

id*string

Id of the saved address, as returned by GET /store/addresses.

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/store/addresses/019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5ca1/default" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Default address updated",  "data": {    "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5ca1",    "label": "Home",    "address": "48 Greenwich Avenue, New York, NY 10011",    "lat": 40.7355,    "lng": -74.002,    "country_code": "US",    "state": "New York",    "city": "New York",    "area": "West Village",    "state_id": null,    "area_id": null,    "is_default": true  }}