List Testimonies History

Retrieves finished testimonies (completed, cancelled) for the authenticated user — the testimonies they created as a client, or the ones they were assigned to as an expert.

HTTP Request

GET /api/v1/me/testimonies/history

Authentication

Requires authentication via Bearer token.

401 Unauthorized

{
  "message": "Unauthenticated."
}

Response

200 OK

A plain data array without pagination. offers is always null here — use Show Testimony to load the offers of a testimony.

{
  "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": null,
          "line2": null,
          "city": null,
          "postalCode": null,
          "parcelNumber": "123",
          "cadastralArea": "456"
        },
        "addressCoords": {
          "lat": 48.30734852531308,
          "lng": 18.086583509280644
        },
        "userCoords": null
      },
      "notes": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
      "cancellationReason": null,
      "acceptedOffer": null,
      "offers": null,
      "createdAt": "2024-12-21T10:41:59+00:00"
    }
  ]
}

Sorting

Use the sort query parameter; default is createdAt DESC.

• No dash (e.g., &sort=createdAt): ascending
• Dash (e.g., &sort=-createdAt): descending
• Allowed fields: name, type, address, purpose, createdAt, completedAt

Any other value is rejected with 422 Unprocessable Content:

{
  "message": "Hodnota sort nieje v zozname povolených hodnôt.",
  "errors": {
    "sort": [
      "Hodnota sort nieje v zozname povolených hodnôt."
    ]
  }
}

Searching

Use the search query parameter for full-text search. The search index is updated asynchronously, so a testimony that just changed state may take a moment to appear in the results.