On this page
warrantyTermsList
query · in the family Warranty terms
What it does
The warranty terms defined at your organization.
The caller's org-group family's ACTIVE LISTING of WarrantyTermsList — doomed records DROP from listings.
What happens
Reads only.
Who may call it
Capability area: Reading your records — Looking up and listing the records of your organization.
- Owner
- System Administrator
- Manager
- Associate Manager
- Warehouse Associate
- Sales Associate
- An API key whose scope allows
api:warrantyTermsList
Returns
WarrantyTerms [WarrantyTerms!]! — Warranty terms — the WARRANTY POLICY TEMPLATE: provider + duration + coverage, attached to EXACTLY ONE of a Product or a Manufacturer (the manufacturer-attached row IS the reusable template). Group-scoped like a Brand (parent = the org group). The ATTACHMENT is the template's IDENTITY — IMMUTABLE at birth (re-attach = recreate); the POLICY payload stays mutable (the future warranty INSTANCE snapshots terms at sale, so a template edit never rewrites issued warranties). The warranty INSTANCE construct is NOT here.
Example request
query ExampleWarrantyTermsList {
warrantyTermsList {
id
sysId
type
caption
status
parentId
rootId
createdAt
updatedAt
revisionNum
revision
provider
durationDays
coverage
productId
manufacturerId
}
}
Example response
{
"data": {
"warrantyTermsList": [
{
"id": "01900000-0000-7000-8000-37386ae00000",
"sysId": "WT-EXMP-0000-000F",
"type": "WarrantyTerms",
"caption": "Blue jeans",
"status": "active",
"parentId": "01900000-0000-7000-8000-065235280000",
"rootId": "01900000-0000-7000-8000-a093dd800000",
"createdAt": "2027-01-31T00:00:00.000Z",
"updatedAt": "2027-01-31T00:00:00.000Z",
"revisionNum": 1,
"revision": "01900000-0000-7000-8000-b7960e180000",
"provider": "manufacturer",
"durationDays": 1,
"coverage": "<coverage>",
"productId": "01900000-0000-7000-8000-969657010000",
"manufacturerId": "01900000-0000-7000-8000-7cefed4d0000"
}
]
},
"extensions": {
"at": {
"callId": "01EXAMPLE-CALL-ID",
"version": {
"requested": null,
"serviced": {
"name": "genesis",
"number": 0
}
}
}
}
}
Errors this call can answer
VALIDATION/INVALID— Something in the request is not valid. (VALIDATION)AUTHN/REQUIRED— Sign in to do this. (AUTHN)AUTHZ/FORBIDDEN— Your role does not allow this action. (AUTHZ)RATE_LIMIT/THROTTLED— Too many requests in a short time. (RATE_LIMIT)