--- title: Get Return Policy by ID slug: api-documentation/get-return-policy-by-id docTags: createdAt: 2026-08-27T16:53:32.339Z --- { "id": "-251T0TYJq4EqSb7xzFNH", "type": "api-oas-v2", "data": { "method": "GET", "url": "https://api.upstartcommerce.com/v1/return-policy/{returnPolicyId}", "servers": [ { "url": "https://api.upstartcommerce.com/v1/return-policy/{returnPolicyId}" } ], "name": "Get Return Policy by ID", "description": "This endpoint returns the details of the specified return policy based on the id passed in.", "contentType": "application/json", "request": { "pathParameters": [ { "kind": "required", "name": "returnPolicyId", "type": "string", "description": "Unique identifier of a return policy.", "format": "uuid" } ], "headerParameters": [ { "name": "accept", "type": "string", "kind": "optional", "description": "Generated from available response content types", "enum": [ "application/json" ], "default": "application/json" }, { "kind": "required", "name": "x-upstart-tenant", "type": "string", "description": "Tenant identifier associated with the site this call is for." }, { "kind": "optional", "name": "x-upstart-site", "type": "string", "description": "Unique identifier for the site." } ], "queryParameters": [], "bodyDataParameters": [], "formDataParameters": [], "oAuthParameters": [ { "id": "NoChannelPortalAccess", "name": "NoChannelPortalAccess", "kind": "optional", "type": "http", "description": "

This authentication is required for clients to interact with any of the management APIs. Similar to 'LoggedIn', it indicates that the user has actually logged into the system, but in this case with a management role.

", "scheme": "bearer" }, { "id": "SessionIdAccess", "name": "SessionIdAccess", "kind": "optional", "type": "http", "description": "This authentication is session based", "scheme": "bearer" } ], "cookieParameters": [] }, "responses": [ { "statusCode": "200", "description": "

Success-return policy returned.

", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "", "customType": "ReturnPolicy", "schema": [ { "name": "id", "kind": "required", "type": "string", "description": "Unique identifier for the return policy. If it is not provided a random one will be generated.", "format": "uuid" }, { "name": "siteIds", "kind": "required", "type": "array", "description": "", "modelRef": "#/components/schemas/SiteId", "customType": "SiteId[]", "schema": [] }, { "name": "name", "kind": "required", "type": "string", "description": "

A human-readable name of the return policy.

" }, { "name": "groups", "kind": "required", "type": "array", "description": "", "modelRef": "#/components/schemas/ReturnPolicyGroup", "customType": "ReturnPolicyGroup[]", "schema": [ { "name": "name", "kind": "required", "type": "string", "description": "

A human-readable name of this return policy group (e.g. King Size Mattress).

" }, { "name": "triggerGroup", "kind": "required", "type": "object", "description": "

A subject that might take place as a trigger or qualifier for a return policy. It can be a

\n", "modelRef": "#/components/schemas/ReturnPolicySubject", "customType": "ReturnPolicySubject[]", "schema": [], "complexType": "oneOf", "complexItems": [ { "name": "ReturnPolicyProduct", "description": "", "modelRef": "#/components/schemas/ReturnPolicyProduct", "schema": [ { "name": "type", "kind": "required", "type": "string", "description": "" }, { "name": "id", "kind": "required", "type": "string", "description": "A product ID of the product." } ] }, { "name": "ReturnPolicySku", "description": "", "modelRef": "#/components/schemas/ReturnPolicySku", "schema": [ { "name": "type", "kind": "required", "type": "string", "description": "" }, { "name": "id", "kind": "required", "type": "string", "description": "A product ID of the product this SKU belongs to." }, { "name": "skuId", "kind": "required", "type": "string", "description": "An ID of this SKU." } ] } ] }, { "name": "qualifyingGroup", "kind": "required", "type": "object", "description": "

A subject that might take place as a trigger or qualifier for a return policy. It can be a

\n", "modelRef": "#/components/schemas/ReturnPolicySubject", "customType": "ReturnPolicySubject[]", "schema": [], "complexType": "oneOf", "complexItems": [ { "name": "ReturnPolicyProduct", "description": "", "modelRef": "#/components/schemas/ReturnPolicyProduct", "schema": [ { "name": "type", "kind": "required", "type": "string", "description": "" }, { "name": "id", "kind": "required", "type": "string", "description": "A product ID of the product." } ] }, { "name": "ReturnPolicySku", "description": "", "modelRef": "#/components/schemas/ReturnPolicySku", "schema": [ { "name": "type", "kind": "required", "type": "string", "description": "" }, { "name": "id", "kind": "required", "type": "string", "description": "A product ID of the product this SKU belongs to." }, { "name": "skuId", "kind": "required", "type": "string", "description": "An ID of this SKU." } ] } ] } ] }, { "name": "unqualifiedTemplate", "kind": "required", "type": "string", "description": "A message template to be populated when this return policy is triggered by cart content but the cart content does not qualify for the return policy." }, { "name": "triggeredTemplate", "kind": "required", "type": "string", "description": "A message template to be populated once this return policy is triggered by cart content." }, { "name": "activationDate", "kind": "optional", "type": "string", "description": "

An optional date determining since when the return policy is activated. If it is not provided, the activation has no lower bound.

", "example": "2021-12-01T00:00:00Z", "format": "date-time" }, { "name": "deactivationDate", "kind": "optional", "type": "string", "description": "

An optional date determining until when the return policy is activated. If it is not provided, the activation has no upper bound.

", "example": "2021-12-21T00:30:00Z", "format": "date-time" }, { "name": "archived", "kind": "optional", "type": "boolean", "description": "Determines whether the return policy is archived or not.", "default": false } ], "modelRef": "#/components/schemas/ReturnPolicy", "isExpanded": true } ] }, { "statusCode": "401", "description": "The provided credentials were not valid for this endpoint. It may be that they are expired or that the user's roles are insufficient.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "", "customType": "ErrorResponse", "schema": [ { "name": "name", "kind": "required", "type": "string", "description": "" }, { "name": "code", "kind": "required", "type": "string", "description": "" }, { "name": "detail", "kind": "required", "type": "string", "description": "" }, { "name": "reason", "kind": "optional", "type": "string", "description": "" } ], "modelRef": "#/components/schemas/ErrorResponse", "isExpanded": true } ] }, { "statusCode": "404", "description": "The requested resource was not found in the NoChannel system.", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "", "customType": "ErrorResponse", "schema": [ { "name": "name", "kind": "required", "type": "string", "description": "" }, { "name": "code", "kind": "required", "type": "string", "description": "" }, { "name": "detail", "kind": "required", "type": "string", "description": "" }, { "name": "reason", "kind": "optional", "type": "string", "description": "" } ], "modelRef": "#/components/schemas/ErrorResponse", "isExpanded": true } ] } ], "hasXCodeSamples": false, "examples": { "languages": [ { "id": "uUUR8YJvThbhVuOiaWifh", "language": "curl", "label": "cURL", "code": "curl --request GET \\\n --url https://api.upstartcommerce.com/v1/return-policy/{returnPolicyId} \\\n --header 'accept: application/json' \\\n --header 'x-upstart-tenant: string'" }, { "id": "j_rVg5Ic1a7TqltAd-pcd", "language": "javascript", "label": "javascript", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\nmyHeaders.append(\"x-upstart-tenant\", \"string\");\n\nvar requestOptions = {\n method: 'GET',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"https://api.upstartcommerce.com/v1/return-policy/{returnPolicyId}\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));" }, { "id": "karmeeHu3zEIJoWnvRTQd", "language": "ruby", "label": "Ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.upstartcommerce.com/v1/return-policy/{returnPolicyId}\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest[\"x-upstart-tenant\"] = \"string\"\n\nresponse = https.request(request)\nputs response.read_body\n" }, { "id": "bP43qAffF_ZQRzu_xsfR5", "language": "python", "label": "Python", "code": "import requests\nimport json\n\nurl = \"https://api.upstartcommerce.com/v1/return-policy/{returnPolicyId}\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json',\n 'x-upstart-tenant': 'string'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n" } ], "selectedLanguageId": "uUUR8YJvThbhVuOiaWifh" }, "results": { "languages": [ { "id": "SZFLRPjmZMF50HRurpYqD", "language": "200", "code": "// Success-return policy returned.\n{\n \"id\": \"\",\n \"siteIds\": [\n \"\"\n ],\n \"name\": \"\",\n \"groups\": [\n {\n \"name\": \"\",\n \"triggerGroup\": {},\n \"qualifyingGroup\": {}\n }\n ],\n \"unqualifiedTemplate\": \"\",\n \"triggeredTemplate\": \"\",\n \"activationDate\": \"2021-12-01T00:00:00Z\",\n \"deactivationDate\": \"2021-12-21T00:30:00Z\",\n \"archived\": false\n}" }, { "id": "1_TkZ7ByWBJzW9upR15RS", "language": "401", "code": "// The provided credentials were not valid for this endpoint. It may be that they are expired or that the user's roles are insufficient.\n{\n \"name\": \"\",\n \"code\": \"\",\n \"detail\": \"\",\n \"reason\": \"\"\n}" }, { "id": "IiDRnA42dEK3LbgU3M5X0", "language": "404", "code": "// The requested resource was not found in the NoChannel system.\n{\n \"name\": \"\",\n \"code\": \"\",\n \"detail\": \"\",\n \"reason\": \"\"\n}" } ], "selectedLanguageId": "SZFLRPjmZMF50HRurpYqD" } }, "children": [ { "text": "" } ] }