Skip to content

List orders by placed-by customer

GET
/v1/list/placed-by/{placedByCustomerId}
curl --request GET \
--url 'https://example.com/orders/v1/list/placed-by/example?Status=Open&SortBy=PlacedAt&SortDir=Asc'

Lists orders placed by a specific customer, identified by their customerId. Supports optional status, placed-at date range, sorting and paging via the query string. Results are filtered by the caller’s per-order access, which is applied after paging: a page may therefore contain fewer than pageSize orders, or be empty while still returning a continuationToken. Keep following the continuationToken until it is null to retrieve all results.

placedByCustomerId
required
string
Status
Allowed values: Open InProgress Completed Cancelled
From
string format: date-time
To
string format: date-time
SortBy
Allowed values: PlacedAt OrderId
SortDir
Allowed values: Asc Desc
PageSize
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
ContinuationToken
string

OK

Media typeapplication/json
object
orders
required
Array<object>
object
orderId
required
string
checkoutId
null | string
placedAt
required
string format: date-time
status
required
Allowed values: Open InProgress Completed Cancelled
soldTo
required
string
placedBy
null | string
productNames
required
Array<string>
references
One of:
null
continuationToken
null | string
Example
{
"orders": [
{
"status": "Open"
}
]
}

Bad Request

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
errors
required
Array<object>
object
fieldName
required
string
message
required
string
code
required
string
traceId
required
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"errors": [
{
"fieldName": "example",
"message": "example"
}
],
"code": "example",
"traceId": "example"
}

Unauthorized

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
code
required
string
traceId
required
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"code": "example",
"traceId": "example"
}

Forbidden

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
code
required
string
traceId
required
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"code": "example",
"traceId": "example"
}

Internal Server Error

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
code
required
string
traceId
required
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"code": "example",
"traceId": "example"
}