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

Get started for freeTalk to us