Appearance

List Offerable Testimonies ​

Allows authenticated experts to fetch testimonies that are open for new offers: testimonies in the pending state whose real estate lies in one of the expert's regions. Testimonies whose region has not been resolved yet (see asynchronous geocoding) are not listed.

HTTP Request ​

GET /api/v1/testimonies/offerable

Response ​

200 OK

Returns Testimony Objects in pending state. The response uses the cursor-pagination envelope with a page size of 9999, so in practice every matching testimony arrives in a single page (see Pagination).

json
{
  "data": [
    {
      "id": "01J5X3Y8ZK2Q4R6T8V0W2X4Y6Z",
      "state": "pending",
      "purpose": "mortgage",
      "client": {
        "firstName": "Peter",
        "lastName": "Novák",
        "regions": null
      },
      "expert": null,
      "realEstate": {
        "type": "house",
        "region": "ba",
        "properties": {
          "parcelCount": 1,
          "storeyCount": 2,
          "otherBuildingCount": 0,
          "detachedGarageCount": 1
        },
        "address": {
          "line1": "Hlavná",
          "line2": "123",
          "city": "Bratislava",
          "postalCode": "811 01",
          "parcelNumber": null,
          "cadastralArea": null
        },
        "addressCoords": {
          "lat": 48.1486,
          "lng": 17.1077
        },
        "userCoords": null
      },
      "notes": "Urgent mortgage valuation needed",
      "cancellationReason": null,
      "acceptedOffer": null,
      "offers": null,
      "createdAt": "2025-01-15T10:30:00+00:00"
    }
  ],
  "links": {
    "first": null,
    "last": null,
    "prev": null,
    "next": null
  },
  "meta": {
    "path": "https://api.brunago.sk/api/v1/testimonies/offerable",
    "per_page": 9999,
    "next_cursor": null,
    "prev_cursor": null
  }
}

Authentication ​

Requires authentication via Bearer token. Only accessible to users with expert role. Email verification is not required.

401 Unauthorized

json
{
  "message": "Unauthenticated."
}

Error Handling ​

Forbidden ​

403 Forbidden

json
{
  "message": "This action is unauthorized."
}

Returned when authenticated user is not an expert. (In production the message is the generic Forbidden.)