Skip to main content
GET
/
api
/
horses
/
my-listings
My Listings
curl --request GET \
  --url https://api.example.com/api/horses/my-listings
{
  "success": true,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "seller_id": "507f191e810c19729de860ea",
      "name": "Thunder",
      "age": 8,
      "breed": "Thoroughbred",
      "discipline": "Show Jumping",
      "pedigree": "Sire: Storm Cat, Dam: Winning Colors",
      "location": {
        "country": "Argentina",
        "region": "Buenos Aires",
        "city": "San Isidro",
        "coordinates": {
          "lat": -34.4708,
          "lng": -58.5247
        }
      },
      "price": 45000,
      "currency": "USD",
      "photos": [
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j1",
          "url": "https://cdn.horsetrust.com/photos/abc123.jpg",
          "caption": "Thunder at competition",
          "is_cover": true,
          "uploaded_at": "2026-03-01T10:00:00Z"
        }
      ],
      "videos": [
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j2",
          "url": "https://youtube.com/watch?v=abc123",
          "embed_url": "https://www.youtube.com/embed/abc123",
          "video_type": "competition",
          "title": "Thunder jumping 1.40m",
          "recorded_at": "2026-02-15T00:00:00Z",
          "uploaded_at": "2026-03-01T10:00:00Z"
        }
      ],
      "status": "active",
      "views_count": 234,
      "created_at": "2026-03-01T10:00:00Z",
      "updated_at": "2026-03-05T15:30:00Z"
    },
    {
      "_id": "507f1f77bcf86cd799439012",
      "seller_id": "507f191e810c19729de860ea",
      "name": "Silver Star",
      "age": 6,
      "breed": "Andalusian",
      "discipline": "Dressage",
      "location": {
        "country": "Argentina",
        "region": "Córdoba",
        "city": "Villa Carlos Paz"
      },
      "price": 38000,
      "currency": "USD",
      "photos": [
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j3",
          "url": "https://cdn.horsetrust.com/photos/def456.jpg",
          "is_cover": true,
          "uploaded_at": "2026-02-20T14:00:00Z"
        },
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j4",
          "url": "https://cdn.horsetrust.com/photos/def457.jpg",
          "is_cover": false,
          "uploaded_at": "2026-02-20T14:00:00Z"
        },
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j5",
          "url": "https://cdn.horsetrust.com/photos/def458.jpg",
          "is_cover": false,
          "uploaded_at": "2026-02-20T14:00:00Z"
        }
      ],
      "videos": [],
      "status": "draft",
      "views_count": 12,
      "created_at": "2026-02-20T14:00:00Z",
      "updated_at": "2026-02-25T10:15:00Z"
    }
  ]
}

Authentication

Required - JWT Bearer token with seller or admin role
Authorization: Bearer YOUR_JWT_TOKEN

Response

success
boolean
Indicates if the request was successful
data
array
Array of horse listings owned by the authenticated user, sorted by creation date (newest first)
_id
string
Horse unique identifier
seller_id
string
Seller ID (matches authenticated user)
name
string
Horse name
age
number
Horse age in years
breed
string
Horse breed
discipline
string
Primary discipline
pedigree
string
Pedigree information
location
object
country
string
Country location
region
string
Region/state
city
string
City
coordinates
object
lat
number
Latitude
lng
number
Longitude
price
number
Listing price
currency
string
Currency code (USD, EUR, ARS, BRL, MXN)
photos
array
Array of photos
_id
string
Photo ID
url
string
Photo URL
caption
string
Photo caption
is_cover
boolean
Whether this is the cover photo
uploaded_at
string
Upload timestamp
videos
array
Array of videos
_id
string
Video ID
url
string
Video URL
embed_url
string
Auto-generated embed URL
video_type
string
Type: training, competition, other
title
string
Video title
description
string
Video description
recorded_at
string
Recording date
uploaded_at
string
Upload timestamp
status
string
Listing status: active, sold, paused, draft
views_count
number
Number of views
created_at
string
Creation timestamp
updated_at
string
Last update timestamp

Notes

  • Returns all listings regardless of status (active, draft, sold, paused)
  • Results are sorted by creation date, newest first
  • Only returns listings owned by the authenticated user
  • No pagination - returns all user’s listings

Examples

curl -X GET "https://api.horsetrust.com/api/horses/my-listings" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
{
  "success": true,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "seller_id": "507f191e810c19729de860ea",
      "name": "Thunder",
      "age": 8,
      "breed": "Thoroughbred",
      "discipline": "Show Jumping",
      "pedigree": "Sire: Storm Cat, Dam: Winning Colors",
      "location": {
        "country": "Argentina",
        "region": "Buenos Aires",
        "city": "San Isidro",
        "coordinates": {
          "lat": -34.4708,
          "lng": -58.5247
        }
      },
      "price": 45000,
      "currency": "USD",
      "photos": [
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j1",
          "url": "https://cdn.horsetrust.com/photos/abc123.jpg",
          "caption": "Thunder at competition",
          "is_cover": true,
          "uploaded_at": "2026-03-01T10:00:00Z"
        }
      ],
      "videos": [
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j2",
          "url": "https://youtube.com/watch?v=abc123",
          "embed_url": "https://www.youtube.com/embed/abc123",
          "video_type": "competition",
          "title": "Thunder jumping 1.40m",
          "recorded_at": "2026-02-15T00:00:00Z",
          "uploaded_at": "2026-03-01T10:00:00Z"
        }
      ],
      "status": "active",
      "views_count": 234,
      "created_at": "2026-03-01T10:00:00Z",
      "updated_at": "2026-03-05T15:30:00Z"
    },
    {
      "_id": "507f1f77bcf86cd799439012",
      "seller_id": "507f191e810c19729de860ea",
      "name": "Silver Star",
      "age": 6,
      "breed": "Andalusian",
      "discipline": "Dressage",
      "location": {
        "country": "Argentina",
        "region": "Córdoba",
        "city": "Villa Carlos Paz"
      },
      "price": 38000,
      "currency": "USD",
      "photos": [
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j3",
          "url": "https://cdn.horsetrust.com/photos/def456.jpg",
          "is_cover": true,
          "uploaded_at": "2026-02-20T14:00:00Z"
        },
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j4",
          "url": "https://cdn.horsetrust.com/photos/def457.jpg",
          "is_cover": false,
          "uploaded_at": "2026-02-20T14:00:00Z"
        },
        {
          "_id": "65f1a2b3c4d5e6f7g8h9i0j5",
          "url": "https://cdn.horsetrust.com/photos/def458.jpg",
          "is_cover": false,
          "uploaded_at": "2026-02-20T14:00:00Z"
        }
      ],
      "videos": [],
      "status": "draft",
      "views_count": 12,
      "created_at": "2026-02-20T14:00:00Z",
      "updated_at": "2026-02-25T10:15:00Z"
    }
  ]
}

Error Responses

401 - Unauthorized

{
  "success": false,
  "message": "Authentication required"
}

403 - Forbidden

{
  "success": false,
  "message": "Seller role required"
}

500 - Server Error

{
  "success": false,
  "message": "Server error"
}

Build docs developers (and LLMs) love