GET api/listings/:id

This search will allow you to get information on a specific Listing in the PetRescue system.

Resource URL

https://www.petrescue.com.au/api/listings/:id

Parameters

id required	The numerical ID of the PetRescue Listing Example Value: `117` Requirement: The id must map to an active Listing

id required

The numerical ID of the PetRescue Listing

Example Value: 117

Requirement: The id must map to an active Listing

Example Request

GET	`https://www.petrescue.com.au/api/listings/117`

Successful Response

A successful request to this resource will return a 200 OK. The response body will contain a JSON representation of the Listing that matches the provided id.

The fields that are returned for a Listing are:

Field	Type	Value
adoption_fee	String	The fee for adopting the pet.
adoption_process	String	The process for adopting the pet.
breeds	Array of Strings	Each breed for the pet. Example Value: `['Border Collie', 'Kelpie']`
breeds_display	String	A string representation of the breed of the pet. Example: Border Collie x Kelpie for a cross. If the pet is a mixed breed, mix will be suffixed on to the end. Example Value: `Border Collie x Kelpie mix`
coat	String	The coat length of the pet. One of `Short`, `Medium`, `Long`. `coat` will only be returned for Cats and Guinea Pigs. For other species `null` will be returned.
coat_colour	String	The coat color of the pet (e.g., "Black", "White and Brown", "Tricolour"). Returns `null` if no color data is available.
contact_number	String	The contact phone number of the listing.
contact_preferred_method	String	The preferred contact method of the group. One of `Email` or `Phone`.
created_at	String	The date the listing was created. Formatted as: `%-d/%-m/%Y %-H:%M`. Example Value: `25/3/2012 17:30`
date_of_birth	String	The date of birth of the pet. Formatted as: `%-d/%-m/%Y`. Returns `null` if there is no available date of birth data for the Listing. Example Value: `25/3/2012`
desexed	Boolean	Whether the pet is desexed (`true`) or not (`false`).
foster_needed	Boolean	Whether the pet requires foster care (`true`) or not (`false`).
gender	String	One of `Male` or `Female`.
group	String	The name of the Rescue Group.
heart_worm_treated	String	Whether the pet has been heart worm treated (`Yes`) or not (`No`), or it is not known (`Unsure`). `heart_worm_tested` will only be returned for Dogs. For other species `null` will be returned.
id	Integer	The id of the listing.
interstate	Boolean	Whether or not the pet can be adopted interstate.
last_updated	String	The the listing was last updated. Formatted as `%-d/%-m/%Y %-H:%M`. Example Value: `25/3/2012 17:30`
medical_notes	String	The medical notes for a listing.
microchip_number	String	The microchip number for the listing.
mix	Boolean	Whether the listing is a mixed breed (`true`) or not (`false`).
multiple_animals	Boolean	Whether the listing contains multiple animals (`true`) or not (`false`).
name	String	The name of the pet.
personality	String	A description of the personality of the pet.
photos	Array	An array of objects containing URLs to different sized photos (served as compressed jpgs) of the listing. Each object is formatted as: `{"small_80":"url", "medium_130":"url", "large_340":"url", "xlarge_900":"url"}` Each jpg is square, with padded whitespace to fill the shorter side of the image. `small_80` is sized to 80px x 80px. `medium_130` is sized to 130px x 130px. `large_340` is sized to 340px x 340px. `xlarge_900` is sized to 900px x 900px.
senior	Boolean	Whether the listing is a senior animal (`true`) or not (`false`).
size	String	The size of the pet. One of `Small`, `Medium` or `Large`. `size` will only return for Dogs. For other species `null` will be returned.
species	String	The name of the species of the pet. Example Value: `Dog`
state	String	An abbreviation of the Australian state the pet is in. Example Value: `WA`
vaccinated	String	Whether the pet has been vaccinated (`Yes`) or not (`No`), or it is not known (`Unsure`). `vaccinated` will only be returned for Cats, Dogs and Rabbits. For other species `null` will be returned.
wormed	String	Whether the pet has been wormed (`Yes`) or not (`No`), or it is not known (`Unsure`). `wormed` will only be returned for Cats and Dogs. For other species `null` will be returned.

Error Response

An erroneous request to this resource will return a 404 Not Found. The response body will contain a JSON object with details of the error.

The error object will contain:

Key	Description
error_code	A string describing the error.
errors	A JSON object containing all of the errors in from request.

If the Listing that matches the provided id is removed or rehomed the response status code will be a 404 Not Found and the response body will be:

{
  "errors":{
    "id":       "has been removed/rehomed",
  },
  "error_code": "inactive_id"
}

If the provided id doesn't actually map to any Listing the response status code will be a 404 Not Found and the response body will be:

{
  "errors":{
    "id":       "does not exist in the system",
  },
  "error_code": "invalid_id"
}

Find a dog on PetRescue

Dog adoption assistance

Search by location

Find a cat on PetRescue

Cat adoption assistance

Search by location

The furry ones

The feathery ones

The big ones

Search by location

Support for pets and their people

Home2Home for vets, shelters & councils

About PetRescue

Our work & impact

Knowledge base

Adoption and pet owner support

GET api/listings/:id

Resource URL

Parameters

Example Request

Successful Response

Error Response

Join the PetRescue community

Find a dog on PetRescue

Dog adoption assistance

Search by location

PetRescue TV

Find a cat on PetRescue

Cat adoption assistance

Search by location

PetRescue TV

The furry ones

The feathery ones

The big ones

Search by location

PetRescue TV

Support for pets and their people

Home2Home for vets, shelters & councils

GET api/listings/:id

Resource URL

Parameters

Example Request

Successful Response

Error Response