Skip to main content

How to use the REST API

Manage your StoreRocket locations programmatically using our REST API.

Updated yesterday

The REST API lets you create, read, update, and delete locations programmatically. It's available on the Business plan.

Getting your API token

  1. Go to API Tokens in your dashboard

  2. Create a new token

  3. Copy it and store it securely. You won't be able to see it again.

Base URL

All API requests go to:

https://storerocket.io/api/v2/projects/{PROJECT_ID}/locations

Replace {PROJECT_ID} with your project's ID (visible in your dashboard URL or API tokens page).

Authentication

Include your API token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Endpoints

List all locations

GET /api/v2/projects/{PROJECT_ID}/locations

Get a single location

GET /api/v2/projects/{PROJECT_ID}/locations/{LOCATION_ID}

Create a location

POST /api/v2/projects/{PROJECT_ID}/locations

Send a JSON body with at minimum: name and address.

Update a location

PUT /api/v2/projects/{PROJECT_ID}/locations/{LOCATION_ID}

Delete a location

DELETE /api/v2/projects/{PROJECT_ID}/locations/{LOCATION_ID}

Example: Create a location

curl -X POST https://storerocket.io/api/v2/projects/YOUR_PROJECT_ID/locations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Downtown Store",
    "address": "123 Main Street",
    "city": "Nashville",
    "state": "TN",
    "zip": "37201",
    "country": "US"
  }'

StoreRocket will automatically geocode the address to get map coordinates.

Rate limits

API requests are rate-limited to prevent abuse. If you hit the limit, you'll get a 429 response. Wait a moment and try again.

Need the full documentation?

The complete API reference with all available fields and response formats is available upon request. Reach out on live chat and we'll send it over.

Did this answer your question?