Get Offers
GET
https://api.getcovent.com/api/v1/offers?listing_id=lst_123&individual_id=ind_123&status=submitted&page=1&page_size=25Retrieve offers with optional filters for listing, individual, or status.
How to Call
Use one of the examples below to call this endpoint from your own integration.
curl -X GET "https://api.getcovent.com/api/v1/offers?listing_id=lst_123&individual_id=ind_123&status=submitted&page=1&page_size=25" \
-H "Authorization: Bearer <API_KEY>" \
-H "Accept: application/json"Request
Review headers, parameters, and body fields before calling this endpoint.
AuthorizationstringRequired
Bearer token for the proposed external API contract.
Example: Bearer <API_KEY>AcceptstringRequired
Response format header.
Example: application/jsonlisting_idstringRequired
listing_id query parameter.
Example: lst_123individual_idstringRequired
individual_id query parameter.
Example: ind_123statusstringRequired
status query parameter.
Example: submittedpagenumberRequired
page query parameter.
Example: 1page_sizenumberRequired
page_size query parameter.
Example: 25Response
200application/jsonitemsarrayRequired
items response field.
Example: [{"id":"off_123","listing_id":"lst_123","individual_id":"ind_123","amount":372000,"status":"submitted","created_at":"2026-04-17T19:45:00Z"}]pagenumberRequired
page response field.
Example: 1page_sizenumberRequired
page_size response field.
Example: 25totalnumberRequired
total response field.
Example: 9Response Example
{
"items": [
{
"id": "off_123",
"listing_id": "lst_123",
"individual_id": "ind_123",
"amount": 372000,
"status": "submitted",
"created_at": "2026-04-17T19:45:00Z"
}
],
"page": 1,
"page_size": 25,
"total": 9
}