Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

RescueGroups.org Animals API

Search and retrieve adoptable animal records.

RescueGroups.org Animals API is one of 8 APIs that RescueGroups.org publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Animals. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 3 JSON Schemas.

This API exposes 3 operations across 3 paths, and defines 10 schemas. It is described by OpenAPI 3.1.0, at version 5.0.0.

Requests are made against 2 base URLs: https://api.rescuegroups.org/v5, https://dev1-api.rescuegroups.org/v5.

3 operations 3 paths 10 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
5.0.0
Base URL
https://api.rescuegroups.org/v5
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

RescueGroups.org Animals API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (apiKeyAuth). It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • apiKeyAuth — API key authorization for public data access.
  • bearerAuth — Bearer token for private/authenticated data access.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Animals 3

Search and retrieve adoptable animal records.

GET
/public/animals
List Public Animals
listPublicAnimals 5 params → 200401429
GET
/public/animals/{animal_id}
Get Public Animal
getPublicAnimal 2 params → 200401404
POST
/public/animals/search/{view_name}
Search Public Animals
searchPublicAnimals 5 params body → 200400401

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are AnimalAttributes (17 properties), GeoDistance (5 properties), Animal (4 properties), SearchFilter (3 properties). Each schema is shown below with its type and property counts.

RelationshipData
object
1 property
AnimalSingleResponse
object
2 properties
SearchFilter
object
3 properties 2 required
GeoDistance
object
5 properties
Animal
object
4 properties
AnimalListResponse
object
3 properties
ErrorResponse
object
1 property
AnimalAttributes
object
17 properties
ResponseMeta
object
3 properties
SearchRequest
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rescuegroups-org-animals-api-openapi.yml Raw ↑

Other APIs RescueGroups.org publishes across the network.

RescueGroups.org Authentication API
RescueGroups.org Breeds API
RescueGroups.org Colors API
RescueGroups.org Organizations API
RescueGroups.org Patterns API
RescueGroups.org Pet Lists API
RescueGroups.org Species API