List orders and payments linked to a listing.
Returns the Square invoices attached to the listing as typed Order rows, with a per-currency summary that stays stable regardless of the filter query params. Read-only - never mutates Square state. Square API failures on individual invoices are logged and skipped so a flaky upstream never causes a 5xx on this endpoint. Cross-agency access returns 404 listing_not_found (not 403) to avoid leaking existence.
| Method | Path |
|---|---|
GET | /api/v1/listings/{listing_number}/orders |
Primary host: https://valara.cloud (legacy alias: https://dash.jacoballenmedia.com).
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
listing_number | path | yes | string | |
status | query | no | string | Filter orders to those in the given Square status. Does NOT affect the summary totals - the summary is a stable denominator for reconciliation. |
paid_since | query | no | string | Include only orders with at least one payment whose processed_at is >= this timestamp (inclusive). ISO-8601 with timezone offset. Does NOT affect the summary. |
Request body
(no request body)
Response
null
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error (see error codes) |
Examples
curl
curl -X GET "https://valara.cloud/api/v1/listings/{listing_number}/orders" \
-H "Authorization: Bearer $VALARA_API_KEY" \
-H "Content-Type: application/json"
Python
import os
import uuid
import httpx
res = httpx.request(
"GET",
"https://valara.cloud/api/v1/listings/{listing_number}/orders",
headers={
"Authorization": f"Bearer {os.environ['VALARA_API_KEY']}",
"Content-Type": "application/json",
},
)
res.raise_for_status()
print(res.json())