Get Horse

Get Horse

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/horses/:id",
  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/:id"

	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/:id")

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",
      "email": "john@example.com",
      "phone": "+54 11 1234-5678",
      "seller_profile": {
        "is_verified_badge": true,
        "years_experience": 15,
        "specialty": "Show Jumping"
      }
    },
    "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": 235,
    "created_at": "2026-03-01T10:00:00Z",
    "updated_at": "2026-03-05T15:30:00Z"
  },
  "vet_record": {
    "_id": "65f1a2b3c4d5e6f7g8h9i0j3",
    "horse_id": "507f1f77bcf86cd799439011",
    "review_date": "2026-02-20T00:00:00Z",
    "health_status": "Excellent condition",
    "certificates": [
      {
        "_id": "65f1a2b3c4d5e6f7g8h9i0j4",
        "url": "https://cdn.horsetrust.com/certs/health_cert.pdf",
        "title": "Health Certificate",
        "uploaded_at": "2026-02-20T10:00:00Z"
      }
    ],
    "vaccines": [
      {
        "name": "Influenza",
        "applied_at": "2026-01-15T00:00:00Z",
        "next_due_at": "2026-07-15T00:00:00Z",
        "batch_number": "FLU2026-A123"
      }
    ],
    "validation_status": "validated",
    "notes": "Annual check-up completed. Horse in excellent health."
  }
}

GET

api

horses

:id

Get Horse

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/horses/:id",
  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/:id"

	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/:id")

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",
      "email": "john@example.com",
      "phone": "+54 11 1234-5678",
      "seller_profile": {
        "is_verified_badge": true,
        "years_experience": 15,
        "specialty": "Show Jumping"
      }
    },
    "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": 235,
    "created_at": "2026-03-01T10:00:00Z",
    "updated_at": "2026-03-05T15:30:00Z"
  },
  "vet_record": {
    "_id": "65f1a2b3c4d5e6f7g8h9i0j3",
    "horse_id": "507f1f77bcf86cd799439011",
    "review_date": "2026-02-20T00:00:00Z",
    "health_status": "Excellent condition",
    "certificates": [
      {
        "_id": "65f1a2b3c4d5e6f7g8h9i0j4",
        "url": "https://cdn.horsetrust.com/certs/health_cert.pdf",
        "title": "Health Certificate",
        "uploaded_at": "2026-02-20T10:00:00Z"
      }
    ],
    "vaccines": [
      {
        "name": "Influenza",
        "applied_at": "2026-01-15T00:00:00Z",
        "next_due_at": "2026-07-15T00:00:00Z",
        "batch_number": "FLU2026-A123"
      }
    ],
    "validation_status": "validated",
    "notes": "Annual check-up completed. Horse in excellent health."
  }
}

Authentication

Optional - Public endpoint, authentication may provide additional features

Path Parameters

string

required

Horse unique identifier (MongoDB ObjectId)

Behavior

Automatically increments view count
Returns only active listings
Includes populated seller information
Returns latest validated vet record if available

Response

boolean

Indicates if the request was successful

object

Horse listing details

string

Horse unique identifier

object

Seller information (populated)

string

Seller ID

string

Seller full name

string

Seller email

string

Seller phone number

object

Complete seller profile information

string

Horse name

number

Horse age in years (0-40)

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 (minimum: 0)

string

Currency code: USD, EUR, ARS, BRL, MXN

array

Array of photos (minimum 3 required)

string

Photo ID

string

required

Photo URL

string

Photo caption

boolean

Whether this is the cover photo

string

Upload timestamp

array

Array of videos

string

Video ID

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 (incremented on each request)

string

Creation timestamp

string

Last update timestamp

object

Latest validated vet record (null if none available)

string

Vet record ID

string

Horse ID

string

Date of veterinary review

string

Overall health status

array

Array of certificate documents

array

Array of vaccine records

string

Status: validated (only validated records returned)

string

Additional notes

Examples

curl -X GET "https://api.horsetrust.com/api/horses/507f1f77bcf86cd799439011" \
  -H "Content-Type: application/json"

const horseId = '507f1f77bcf86cd799439011';
const response = await fetch(`https://api.horsetrust.com/api/horses/${horseId}`, {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});

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

import requests

horse_id = '507f1f77bcf86cd799439011'
response = requests.get(
    f'https://api.horsetrust.com/api/horses/{horse_id}'
)

data = response.json()
print(data)

{
  "success": true,
  "data": {
    "_id": "507f1f77bcf86cd799439011",
    "seller_id": {
      "_id": "507f191e810c19729de860ea",
      "full_name": "John Smith",
      "email": "john@example.com",
      "phone": "+54 11 1234-5678",
      "seller_profile": {
        "is_verified_badge": true,
        "years_experience": 15,
        "specialty": "Show Jumping"
      }
    },
    "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": 235,
    "created_at": "2026-03-01T10:00:00Z",
    "updated_at": "2026-03-05T15:30:00Z"
  },
  "vet_record": {
    "_id": "65f1a2b3c4d5e6f7g8h9i0j3",
    "horse_id": "507f1f77bcf86cd799439011",
    "review_date": "2026-02-20T00:00:00Z",
    "health_status": "Excellent condition",
    "certificates": [
      {
        "_id": "65f1a2b3c4d5e6f7g8h9i0j4",
        "url": "https://cdn.horsetrust.com/certs/health_cert.pdf",
        "title": "Health Certificate",
        "uploaded_at": "2026-02-20T10:00:00Z"
      }
    ],
    "vaccines": [
      {
        "name": "Influenza",
        "applied_at": "2026-01-15T00:00:00Z",
        "next_due_at": "2026-07-15T00:00:00Z",
        "batch_number": "FLU2026-A123"
      }
    ],
    "validation_status": "validated",
    "notes": "Annual check-up completed. Horse in excellent health."
  }
}

Error Responses

400 - Invalid Horse ID

{
  "success": false,
  "message": "Invalid horse ID"
}

404 - Horse Not Found

{
  "success": false,
  "message": "Horse not found"
}

500 - Server Error

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

List Horses

Create Horse

⌘I

Authentication

Horses

Chat

Admin

Authentication

Path Parameters

Behavior

Response

Examples

Error Responses

400 - Invalid Horse ID

404 - Horse Not Found

500 - Server Error

​Authentication

​Path Parameters

​Behavior

​Response

​Examples

​Error Responses

​400 - Invalid Horse ID

​404 - Horse Not Found

​500 - Server Error

Authentication

Path Parameters

Behavior

Response

Examples

Error Responses

400 - Invalid Horse ID

404 - Horse Not Found

500 - Server Error