List Offerable Testimonies

Allows authenticated experts to fetch testimonies that are open for new offers (currently in a pending state).

HTTP Request

GET /api/v1/testimonies/offerable

Response

200 OK

Returns a paginated list of Testimony Objects in pending state.

{
  "data": [
    {
      "id": "9dc6f0f8-f7d7-4676-8c07-13a1f0865681",
      "state": "pending",
      "purpose": "mortgage",
      "price": null,
      "client": {
        "email": "client@example.com",
        "phone": "+421902123456",
        "firstName": "Peter",
        "lastName": "Novák",
        "role": "client",
        "regions": null,
        "emailVerified": true
      },
      "expert": null,
      "realEstate": {
        "type": "house",
        "region": "ba",
        "properties": {
          "parcelCount": 1,
          "storeyCount": 2,
          "otherBuildingCount": 0,
          "detachedGarageCount": 1
        },
        "address": {
          "line1": "Hlavná 123",
          "line2": null,
          "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": [],
      "createdAt": "2025-01-15T10:30:00+00:00"
    }
  ],
  "links": {
    "first": "https://api.brunago.sk/api/v1/testimonies/offerable?page=1",
    "last": "https://api.brunago.sk/api/v1/testimonies/offerable?page=3",
    "prev": null,
    "next": "https://api.brunago.sk/api/v1/testimonies/offerable?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 3,
    "per_page": 15,
    "to": 15,
    "total": 42
  }
}

Authentication

Requires authentication via Bearer token. Only accessible to users with expert role.

401 Unauthorized

{
  "message": "Unauthenticated."
}

Error Handling

Forbidden

403 Forbidden

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

Returned when authenticated user is not an expert.