query · Module: Catalog · Requires catalog:read
Arguments
Returns
CatalogOption!
Errors
Errors are returned inerrors[], with the REST error object in extensions (type, code, param, request_id), using the codes in Conventions §9.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
query Option($id: ID!) {
option(id: $id) {
id
object
name
status
livemode
created
updated
key
standardized
carrier_code
description
conflicts_with
requires
surcharge
version
}
}
{
"id": "opt_1a2B3c"
}
{
"data": {
"option": {
"id": "opt_1a2B3c",
"object": "option",
"name": "Example",
"status": "draft",
"livemode": true,
"created": 1791302400,
"updated": 1791302400,
"key": "signature",
"standardized": true,
"carrier_code": "EXPRESS_WORLDWIDE",
"description": "Example description",
"conflicts_with": [
"example"
],
"requires": [
"example"
],
"surcharge": "example",
"version": 3
}
}
}
Retrieve a CatalogOption
query Option($id: ID!) {
option(id: $id) {
id
object
name
status
livemode
created
updated
key
standardized
carrier_code
description
conflicts_with
requires
surcharge
version
}
}
{
"id": "opt_1a2B3c"
}
{
"data": {
"option": {
"id": "opt_1a2B3c",
"object": "option",
"name": "Example",
"status": "draft",
"livemode": true,
"created": 1791302400,
"updated": 1791302400,
"key": "signature",
"standardized": true,
"carrier_code": "EXPRESS_WORLDWIDE",
"description": "Example description",
"conflicts_with": [
"example"
],
"requires": [
"example"
],
"surcharge": "example",
"version": 3
}
}
}
query · Module: Catalog · Requires catalog:read
| Argument | Type | Description |
|---|---|---|
id | ID! | The object’s ID. |
CatalogOption!
| Field | Type |
|---|---|
id | String! |
object | CatalogOptionObject! |
livemode | Boolean! |
created | Int! |
updated | Int |
key | String! |
standardized | Boolean |
carrier_code | String |
name | String |
description | String |
schema | JsonSchema! |
conflicts_with | [String!] |
requires | [String!] |
surcharge | String |
status | CatalogOptionStatus! |
version | Int |
user_metadata | UserMetadata |
carrier_metadata | CarrierMetadata |
system_metadata | SystemMetadata |
errors[], with the REST error object in extensions (type, code, param, request_id), using the codes in Conventions §9.
query Option($id: ID!) {
option(id: $id) {
id
object
name
status
livemode
created
updated
key
standardized
carrier_code
description
conflicts_with
requires
surcharge
version
}
}
{
"id": "opt_1a2B3c"
}
{
"data": {
"option": {
"id": "opt_1a2B3c",
"object": "option",
"name": "Example",
"status": "draft",
"livemode": true,
"created": 1791302400,
"updated": 1791302400,
"key": "signature",
"standardized": true,
"carrier_code": "EXPRESS_WORLDWIDE",
"description": "Example description",
"conflicts_with": [
"example"
],
"requires": [
"example"
],
"surcharge": "example",
"version": 3
}
}
}