partnerOrderApprovals
Requires permission customers:customer_user:read.
One customer account's over-limit checkout requests, newest first, for the SELLER's console. The account's own approver decides from the app; a seller decides via partnerApproveOrderRequest / partnerDeclineOrderRequest. Pass status "PENDING" for the queue, omit it for full history.
Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.
Example:
- GraphQL
- cURL
query PartnerOrderApprovals($partnerId: ID!) {
partnerOrderApprovals(partnerId: $partnerId) {
items {
id
poNumber
requestNumber
resultingOrderNumber
companyName
decidedByName
}
}
}
curl -X POST "https://<api-host>/graphql" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data @- <<'EOF'
{
"query": "query PartnerOrderApprovals($partnerId: ID!) {\n partnerOrderApprovals(partnerId: $partnerId) {\n items {\n id\n poNumber\n requestNumber\n resultingOrderNumber\n companyName\n decidedByName\n }\n }\n}",
"variables": {
"partnerId": "id"
}
}
EOF
Variables:
{
"partnerId": "id"
}
Response:
{
"data": {
"partnerOrderApprovals": {
"items": [
{
"id": "id",
"poNumber": "string",
"requestNumber": "string",
"resultingOrderNumber": "string",
"companyName": "string",
"decidedByName": "string"
}
]
}
}
}
partnerOrderApprovals(
limit: Int
page: Int
partnerId: ID!
status: String
): CustomerOrderApprovalConnection!
Arguments
partnerOrderApprovals.limit ● Int scalar
Maximum number of records to return.
partnerOrderApprovals.page ● Int scalar
The page to return, starting at 1.
partnerOrderApprovals.partnerId ● ID! non-null scalar
The ID of the partner.
partnerOrderApprovals.status ● String scalar
Only requests with this status.
Type
CustomerOrderApprovalConnection object
A page of order approval requests.