List listings (paginated, agency-scoped, newest-updated first).
Returns a paginated page of listings owned by the caller's agency hierarchy. Sorted by updated_at descending. Default excludes Archived status; pass ?status=Archived to retrieve archived listings explicitly. Filters AND-compose: status, agent_id (matches either agent_one_id or agent_two_id), created_since and updated_since (both inclusive $gte). Use the returned next_cursor to fetch the next page; no cursor on the final page.
| Method | Path |
|---|---|
GET | /api/v1/listings |
Primary host: https://valara.cloud (legacy alias: https://dash.jacoballenmedia.com).
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
status | query | no | string | Exact status match. When omitted, Archived rows are excluded from the response. |
agent_id | query | no | string | Filter to listings where the given user id is the primary OR co-listing agent. |
created_since | query | no | string | Inclusive lower bound on created_at (>= boundary). |
updated_since | query | no | string | Inclusive lower bound on updated_at (>= boundary). |
limit | query | no | string | Page size (1-100, default 25). |
cursor | query | no | string | Opaque cursor returned by the previous page. |
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" \
-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",
headers={
"Authorization": f"Bearer {os.environ['VALARA_API_KEY']}",
"Content-Type": "application/json",
},
)
res.raise_for_status()
print(res.json())