Show Testimony

Returns detailed information about a single testimony. This is the only endpoint that includes the offers array (offers from approved experts).

HTTP Request

GET /api/v1/testimonies/:testimonyId

Authentication

Requires authentication via Bearer token. Only accessible to the testimony's client or the assigned expert. Email verification is not required.

401 Unauthorized

{
  "message": "Unauthenticated."
}

Error Handling

Forbidden

403 Forbidden

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

Returned when the authenticated user is neither the testimony's client nor its assigned expert. (In production the message is the generic Forbidden, see Error Responses.)

Response

200 OK

{
  "data": {
    "id": "01J5X3Y8ZK2Q4R6T8V0W2X4Y6Z",
    "state": "cancelled",
    "purpose": "mortgage",
    "client": {
      "firstName": "Pavol",
      "lastName": "Paška",
      "regions": null
    },
    "expert": null,
    "realEstate": {
      "type": "house",
      "region": "nr",
      "properties": {
        "parcelCount": 2,
        "storeyCount": 1,
        "otherBuildingCount": 0,
        "detachedGarageCount": 1
      },
      "address": {
        "line1": "Tríbečská",
        "line2": "5",
        "city": "Nitra",
        "postalCode": "949 01",
        "parcelNumber": "121212",
        "cadastralArea": "123455"
      },
      "addressCoords": {
        "lat": 48.30734852531308,
        "lng": 18.086583509280644
      },
      "userCoords": null
    },
    "notes": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
    "cancellationReason": null,
    "acceptedOffer": null,
    "offers": [],
    "createdAt": "2024-12-21T10:41:59+00:00"
  }
}

For an accepted or completed testimony, expert holds the assigned expert and acceptedOffer the chosen Offer, whose expert is the same Counterparty object:

{
  "expert": {
    "firstName": "Ján",
    "lastName": "Novák",
    "regions": ["nr", "tt", "ba"]
  },
  "acceptedOffer": {
    "id": "01J5X4A2B3C4D5E6F7G8H9J0K1",
    "price": 500,
    "elaborationInDays": 14,
    "commissionAmount": 105,
    "commissionPercent": 21,
    "expertAmount": 395,
    "expert": {
      "firstName": "Ján",
      "lastName": "Novák",
      "regions": ["nr", "tt", "ba"]
    }
  }
}