Policy

Version 2019-10

You can use the Policy resource to access the policies that a merchant has configured for their shop, such as their refund and privacy policies.

Only the shop owner can edit this information from the Shopify admin. The Policy resource lets you only retrieve information about a shop's policies.

What you can do with Policy

The Shopify API lets you do the following with the Policy resource. More detailed versions of these general actions may be available:

Policy properties

title 
"title": "Refund Policy"

The name of the policy.
body 
"body": "You have 30 days to get a refund"

A description of the policy.
url 
"url": "https://apple.myshopify.com/690933842/policies/878590288"

The public URL of the policy.
created_at 
"created_at": "2012-02-15T15:12:21-05:00"

The date and time (ISO 8601 format) when the policy was created.
updated_at 
"updated_at": "2012-08-24T14:01:47-04:00"

The date and time (ISO 8601 format) when the policy was last modified.
handle 
"handle": "terms-of-service"

A unique identifer for the policy used to build the policy's URL.

Endpoints

GET /admin/api/2019-10/policies.json
Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/2020-07/policies.json
View Response 
HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2020-09-08T13:22:58-04:00",
      "updated_at": "2020-09-08T13:22:58-04:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590288"
    }
  ]
}
Version 2020-01

You can use the Policy resource to access the policies that a merchant has configured for their shop, such as their refund and privacy policies.

Only the shop owner can edit this information from the Shopify admin. The Policy resource lets you only retrieve information about a shop's policies.

What you can do with Policy

The Shopify API lets you do the following with the Policy resource. More detailed versions of these general actions may be available:

Policy properties

title 
"title": "Refund Policy"

The name of the policy.
body 
"body": "You have 30 days to get a refund"

A description of the policy.
url 
"url": "https://apple.myshopify.com/690933842/policies/878590288"

The public URL of the policy.
created_at 
"created_at": "2012-02-15T15:12:21-05:00"

The date and time (ISO 8601 format) when the policy was created.
updated_at 
"updated_at": "2012-08-24T14:01:47-04:00"

The date and time (ISO 8601 format) when the policy was last modified.
handle 
"handle": "terms-of-service"

A unique identifer for the policy used to build the policy's URL.

Endpoints

GET /admin/api/2020-01/policies.json
Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/2020-07/policies.json
View Response 
HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2020-09-08T13:22:58-04:00",
      "updated_at": "2020-09-08T13:22:58-04:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590288"
    }
  ]
}
Version 2020-04

You can use the Policy resource to access the policies that a merchant has configured for their shop, such as their refund and privacy policies.

Only the shop owner can edit this information from the Shopify admin. The Policy resource lets you only retrieve information about a shop's policies.

What you can do with Policy

The Shopify API lets you do the following with the Policy resource. More detailed versions of these general actions may be available:

Policy properties

title 
"title": "Refund Policy"

The name of the policy.
body 
"body": "You have 30 days to get a refund"

A description of the policy.
url 
"url": "https://apple.myshopify.com/690933842/policies/878590288"

The public URL of the policy.
created_at 
"created_at": "2012-02-15T15:12:21-05:00"

The date and time (ISO 8601 format) when the policy was created.
updated_at 
"updated_at": "2012-08-24T14:01:47-04:00"

The date and time (ISO 8601 format) when the policy was last modified.
handle 
"handle": "terms-of-service"

A unique identifer for the policy used to build the policy's URL.

Endpoints

GET /admin/api/2020-04/policies.json
Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/2020-07/policies.json
View Response 
HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2020-09-08T13:22:58-04:00",
      "updated_at": "2020-09-08T13:22:58-04:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590288"
    }
  ]
}
Version 2020-07 (Latest)

You can use the Policy resource to access the policies that a merchant has configured for their shop, such as their refund and privacy policies.

Only the shop owner can edit this information from the Shopify admin. The Policy resource lets you only retrieve information about a shop's policies.

What you can do with Policy

The Shopify API lets you do the following with the Policy resource. More detailed versions of these general actions may be available:

Policy properties

title 
"title": "Refund Policy"

The name of the policy.
body 
"body": "You have 30 days to get a refund"

A description of the policy.
url 
"url": "https://apple.myshopify.com/690933842/policies/878590288"

The public URL of the policy.
created_at 
"created_at": "2012-02-15T15:12:21-05:00"

The date and time (ISO 8601 format) when the policy was created.
updated_at 
"updated_at": "2012-08-24T14:01:47-04:00"

The date and time (ISO 8601 format) when the policy was last modified.
handle 
"handle": "terms-of-service"

A unique identifer for the policy used to build the policy's URL.

Endpoints

GET /admin/api/2020-07/policies.json
Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/2020-07/policies.json
View Response 
HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2020-09-08T13:22:58-04:00",
      "updated_at": "2020-09-08T13:22:58-04:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590288"
    }
  ]
}
Version 2020-10 (Release candidate)

You can use the Policy resource to access the policies that a merchant has configured for their shop, such as their refund and privacy policies.

Only the shop owner can edit this information from the Shopify admin. The Policy resource lets you only retrieve information about a shop's policies.

What you can do with Policy

The Shopify API lets you do the following with the Policy resource. More detailed versions of these general actions may be available:

Policy properties

title 
"title": "Refund Policy"

The name of the policy.
body 
"body": "You have 30 days to get a refund"

A description of the policy.
url 
"url": "https://apple.myshopify.com/690933842/policies/878590288"

The public URL of the policy.
created_at 
"created_at": "2012-02-15T15:12:21-05:00"

The date and time (ISO 8601 format) when the policy was created.
updated_at 
"updated_at": "2012-08-24T14:01:47-04:00"

The date and time (ISO 8601 format) when the policy was last modified.
handle 
"handle": "terms-of-service"

A unique identifer for the policy used to build the policy's URL.

Endpoints

GET /admin/api/2020-10/policies.json
Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/2020-07/policies.json
View Response 
HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2020-09-08T13:22:58-04:00",
      "updated_at": "2020-09-08T13:22:58-04:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590288"
    }
  ]
}