List Horses

curl --request GET \
  --url https://api.example.com/api/horses

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/horses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/horses"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/horses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "seller_id": {
        "_id": "507f191e810c19729de860ea",
        "full_name": "John Smith",
        "seller_profile": {
          "is_verified_badge": true
        }
      },
      "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": [
        {
          "url": "https://cdn.horsetrust.com/photos/abc123.jpg",
          "caption": "Thunder at competition",
          "is_cover": true,
          "uploaded_at": "2026-03-01T10:00:00Z"
        }
      ],
      "videos": [
        {
          "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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 12,
    "total": 45,
    "pages": 4
  }
}

GET

api

horses

List Horses

curl --request GET \
  --url https://api.example.com/api/horses

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/horses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/horses"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/horses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "seller_id": {
        "_id": "507f191e810c19729de860ea",
        "full_name": "John Smith",
        "seller_profile": {
          "is_verified_badge": true
        }
      },
      "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": [
        {
          "url": "https://cdn.horsetrust.com/photos/abc123.jpg",
          "caption": "Thunder at competition",
          "is_cover": true,
          "uploaded_at": "2026-03-01T10:00:00Z"
        }
      ],
      "videos": [
        {
          "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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 12,
    "total": 45,
    "pages": 4
  }
}

Authentication

Optional - Public endpoint, authentication provides additional features

Query Parameters

string

Filter by breed (case-insensitive partial match)

string

Filter by discipline (case-insensitive partial match)

string

Filter by country (case-insensitive partial match)

string

Filter by region (case-insensitive partial match)

number

Minimum price filter

number

Maximum price filter

string

Full-text search across name, breed, discipline, and pedigree

number

default:"1"

Page number for pagination (minimum: 1)

number

default:"12"

Number of results per page (minimum: 1, maximum: 50)

string

default:"created_at"

Sort order. Options:

created_at - Newest first (default)
price_asc - Price low to high
price_desc - Price high to low
age - Age ascending

Response

boolean

Indicates if the request was successful

array

Array of horse listings

string

Horse unique identifier

object

Seller information

string

Seller ID

string

Seller full name

object

boolean

Whether seller has verified badge

string

Horse name

number

Horse age in years

string

Horse breed

string

Primary discipline

string

Pedigree information

object

string

required

Country location

string

required

Region/state

string

City

object

number

Latitude

number

Longitude

number

Listing price

string

Currency code (USD, EUR, ARS, BRL, MXN)

array

Array of photos (minimum 3)

string

required

Photo URL

string

Photo caption

boolean

Whether this is the cover photo

string

Upload timestamp

array

Array of videos

string

required

Video URL

string

Auto-generated embed URL for YouTube/Vimeo

string

required

Type: training, competition, other

string

Video title

string

Video description

string

required

Recording date

string

Upload timestamp

string

Listing status: active, sold, paused, draft

number

Number of views

string

Creation timestamp

string

Last update timestamp

object

Pagination metadata

number

Current page number

number

Results per page

number

Total number of results

number

Total number of pages

Examples

curl -X GET "https://api.horsetrust.com/api/horses?breed=thoroughbred&discipline=jumping&page=1&limit=12&sort=price_asc" \
  -H "Content-Type: application/json"

const response = await fetch('https://api.horsetrust.com/api/horses?breed=thoroughbred&discipline=jumping&page=1&limit=12&sort=price_asc', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.horsetrust.com/api/horses',
    params={
        'breed': 'thoroughbred',
        'discipline': 'jumping',
        'page': 1,
        'limit': 12,
        'sort': 'price_asc'
    }
)

data = response.json()
print(data)

{
  "success": true,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "seller_id": {
        "_id": "507f191e810c19729de860ea",
        "full_name": "John Smith",
        "seller_profile": {
          "is_verified_badge": true
        }
      },
      "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": [
        {
          "url": "https://cdn.horsetrust.com/photos/abc123.jpg",
          "caption": "Thunder at competition",
          "is_cover": true,
          "uploaded_at": "2026-03-01T10:00:00Z"
        }
      ],
      "videos": [
        {
          "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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 12,
    "total": 45,
    "pages": 4
  }
}

Error Responses

boolean

false

string

Error description

500 - Server Error

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

Update Seller Profile

Get Horse

⌘I

Authentication

Horses

Chat

Admin

List Horses

Authentication

Query Parameters

Response

Examples

Error Responses

500 - Server Error

​Authentication

​Query Parameters

​Response

​Examples

​Error Responses

​500 - Server Error

Authentication

Query Parameters

Response

Examples

Error Responses

500 - Server Error