List Policies

curl --request GET \
  --url https://api.launchmystore.io/policies/get-all-policies \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.launchmystore.io/policies/get-all-policies"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.launchmystore.io/policies/get-all-policies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.launchmystore.io/policies/get-all-policies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.launchmystore.io/policies/get-all-policies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.launchmystore.io/policies/get-all-policies")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.launchmystore.io/policies/get-all-policies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "state": "success",
  "message": null,
  "data": [
    {
      "policyId": "b8b0f1a2-3c4d-4e5f-9a0b-1c2d3e4f5a6b",
      "policyType": "Refund Policy",
      "policyContent": "<p>We offer a 30-day return policy...</p>",
      "storeId": "f73049dc-b4d4-4f85-99c2-681a5e351a8a",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "policyId": "c9c1f2b3-4d5e-5f6a-0b1c-2d3e4f5a6b7c",
      "policyType": "Privacy Policy",
      "policyContent": "<p>Your privacy is important to us...</p>",
      "storeId": "f73049dc-b4d4-4f85-99c2-681a5e351a8a",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "count": null,
  "pagination": null
}

GET

policies

get-all-policies

List Policies

curl --request GET \
  --url https://api.launchmystore.io/policies/get-all-policies \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.launchmystore.io/policies/get-all-policies"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.launchmystore.io/policies/get-all-policies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.launchmystore.io/policies/get-all-policies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.launchmystore.io/policies/get-all-policies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.launchmystore.io/policies/get-all-policies")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.launchmystore.io/policies/get-all-policies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "state": "success",
  "message": null,
  "data": [
    {
      "policyId": "b8b0f1a2-3c4d-4e5f-9a0b-1c2d3e4f5a6b",
      "policyType": "Refund Policy",
      "policyContent": "<p>We offer a 30-day return policy...</p>",
      "storeId": "f73049dc-b4d4-4f85-99c2-681a5e351a8a",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "policyId": "c9c1f2b3-4d5e-5f6a-0b1c-2d3e4f5a6b7c",
      "policyType": "Privacy Policy",
      "policyContent": "<p>Your privacy is important to us...</p>",
      "storeId": "f73049dc-b4d4-4f85-99c2-681a5e351a8a",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "count": null,
  "pagination": null
}

This endpoint is part of the merchant Admin API and is authenticated with a merchant access token (not an app OAuth access token). It is not callable with an app /api/v1/ access token.

List Policies

Returns the store policies (refund, privacy, terms, etc.) configured for a store. This is a merchant-scoped endpoint authenticated with a merchant session (JWT), not an OAuth app token.

Policies are also exposed to themes on the storefront through the shop.policies Liquid drop, so most public/storefront use cases read them from the rendered page rather than calling this endpoint directly.

Request

curl -X GET "https://api.launchmystore.io/policies/get-all-policies?storeId=YOUR_STORE_ID" \
  -H "Authorization: Bearer YOUR_MERCHANT_TOKEN"

You may identify the store either by storeId or by domainSlug.

Query Parameters

storeId

string

Store ID (UUID). Provide this or domainSlug.

domainSlug

string

Store domain (e.g. mystore.launchmystore.io). Resolved to a store ID server-side. Provide this or storeId.

type

string

Optional filter matching against the policy type (case-insensitive, partial match), e.g. Refund.

Response

The platform returns the standard response envelope. data is an array of policy records.

status

integer

HTTP status code.

state

string

Result state (success, error, info).

message

string

Optional message (may be null).

data

array

Array of policy records.

Show Policy Object

policyId

string

Unique policy ID (UUID).

policyType

string

Policy type. One of Privacy Policy, Refund Policy, Terms and Conditions.

policyContent

string

Policy body (HTML/text).

storeId

string

Owning store ID.

createdAt

string

ISO-8601 creation timestamp.

updatedAt

string

ISO-8601 last-updated timestamp.

Example Response

{
  "status": 200,
  "state": "success",
  "message": null,
  "data": [
    {
      "policyId": "b8b0f1a2-3c4d-4e5f-9a0b-1c2d3e4f5a6b",
      "policyType": "Refund Policy",
      "policyContent": "<p>We offer a 30-day return policy...</p>",
      "storeId": "f73049dc-b4d4-4f85-99c2-681a5e351a8a",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "policyId": "c9c1f2b3-4d5e-5f6a-0b1c-2d3e4f5a6b7c",
      "policyType": "Privacy Policy",
      "policyContent": "<p>Your privacy is important to us...</p>",
      "storeId": "f73049dc-b4d4-4f85-99c2-681a5e351a8a",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "count": null,
  "pagination": null
}

Method	Route	Description
`POST`	`/policies/add-policy`	Create a policy
`GET`	`/policies/get-policy/:policyId`	Read one policy
`PATCH`	`/policies/update-policies/:policyId`	Update a policy
`DELETE`	`/policies/delete-policy/:policyId`	Delete a policy

Update Shop Update Policy

​List Policies

​Request

​Query Parameters

​Response

​Example Response

​Related Endpoints

List Policies

Request

Query Parameters

Response

Example Response

Related Endpoints