---
title: "Search adoptable pets"
method: GET
path: "/api/v1/pets"
---

# Search adoptable pets

`GET /api/v1/pets`

## Request

- Base URL: `https://petnecto.com`
- URL: `https://petnecto.com/api/v1/pets`
- Auth: none declared

## Query parameters

- `country` 'TW' | 'US' | 'ES' | 'AT'
- `region` string
- `near` string
- `miles` integer
- `km` integer
- `species` 'Dog' | 'Cat' | 'Rabbit' | 'Bird' | 'Horse' | 'Small pet' | 'Reptile' | 'Pig' | 'Barnyard'
- `age` 'Baby' | 'Young' | 'Adult' | 'Senior'
- `size` 'Small' | 'Medium' | 'Large' | 'X-Large'
- `sex` 'Male' | 'Female'
- `good_with` string
- `page` integer
- `cursor` string
- `detail` 'full' | 'brief'
- `limit` integer
- `q` string
- `breed` string
- `color` 'black' | 'white' | 'brown' | 'yellow' | 'grey' | 'orange' | 'cream' | 'tabby' | 'calico' | 'spotted'
- `shelter` string
- `sort` 'relevance' | 'newest' | 'listed' | 'distance' | 'photo'
- `photo` 'good'
- `min_photo_px` integer
- `facets` '1'
- `lang` 'en' | 'es' | 'zh-Hant' | 'zh-Hans' | 'ko' | 'ja' | 'vi' | 'fr' | 'ar' | 'tl'
- `output` 'json' | 'md'
- `found` 'include' | 'exclude' | 'only'
- `format` 'atom'

## Response `200`

The answer as JSON (or Markdown with output=md)

- object

## Other responses

- `400`: What went wrong, in a sentence
- `429`: What went wrong, in a sentence
- `502`: What went wrong, in a sentence
- `503`: What went wrong, in a sentence

---

[API](https://skmtc.dev/petnecto/apis/petnecto-api.md) · [All operations](https://skmtc.dev/petnecto/apis/petnecto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/petnecto/apis/petnecto-api/revisions/788a55948701?raw)