Policy

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:

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

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-01/policies.json

View Response

HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2021-01-01T14:24:56-05:00",
      "updated_at": "2021-01-01T14:24:56-05:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590289"
    }
  ]
}

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:

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

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-04/policies.json

View Response

HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2021-01-01T14:24:56-05:00",
      "updated_at": "2021-01-01T14:24:56-05:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590289"
    }
  ]
}

Version 2020-07

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:

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

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": "2021-01-01T14:24:56-05:00",
      "updated_at": "2021-01-01T14:24:56-05:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590289"
    }
  ]
}

Version 2020-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:

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

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-10/policies.json

View Response

HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2021-01-01T14:24:56-05:00",
      "updated_at": "2021-01-01T14:24:56-05:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590289"
    }
  ]
}

Version 2021-01 (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:

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

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/2021-01/policies.json

Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/2021-01/policies.json

View Response

HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2021-01-01T14:24:56-05:00",
      "updated_at": "2021-01-01T14:24:56-05:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590289"
    }
  ]
}

Version 2021-04 (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:

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

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/2021-04/policies.json

Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/2021-04/policies.json

View Response

HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2021-01-01T14:24:56-05:00",
      "updated_at": "2021-01-01T14:24:56-05:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590289"
    }
  ]
}

Version unstable

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:

GET /admin/api/unstable/policies.json Retrieves a list of the shop's policies

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/unstable/policies.json

Retrieves a list of the shop's policies

Retrieve a list of the shop's policies

GET /admin/api/unstable/policies.json

View Response

HTTP/1.1 200 OK
{
  "policies": [
    {
      "body": "You have 30 days to get a refund",
      "created_at": "2021-01-01T14:24:56-05:00",
      "updated_at": "2021-01-01T14:24:56-05:00",
      "handle": "refund-policy",
      "title": "Refund policy",
      "url": "https://apple.myshopify.com/690933842/policies/878590289"
    }
  ]
}