Add a foster home
curl --request POST \
--url https://{organization}.rescueconsole.com/api/animals/foster-homes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"person_id": "e5b7a1c6-9b8f-4ace-9c5d-7fb0a0ae2c54",
"capacity": 2,
"species_preferences": [
"cat"
],
"accepts_bottle_babies": true,
"approved_on": "2026-09-01",
"notes": "Spare room, no other pets."
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
person_id: 'e5b7a1c6-9b8f-4ace-9c5d-7fb0a0ae2c54',
capacity: 2,
species_preferences: ['cat'],
accepts_bottle_babies: true,
approved_on: '2026-09-01',
notes: 'Spare room, no other pets.'
})
};
fetch('https://{organization}.rescueconsole.com/api/animals/foster-homes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{organization}.rescueconsole.com/api/animals/foster-homes"
payload = {
"person_id": "e5b7a1c6-9b8f-4ace-9c5d-7fb0a0ae2c54",
"capacity": 2,
"species_preferences": ["cat"],
"accepts_bottle_babies": True,
"approved_on": "2026-09-01",
"notes": "Spare room, no other pets."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"foster_home": {
"id": "<string>",
"person_id": "<string>",
"status": "active",
"capacity": 123,
"spots_filled": 123,
"spots_available": 123,
"is_full": true,
"species_preferences": [
"<string>"
],
"accepts_medical": true,
"accepts_bottle_babies": true,
"accepts_behavioral": true,
"approved_on": "<string>",
"notes": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"person": {
"id": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"display_name": "<string>",
"email": "<string>",
"phone": "<string>"
}
}
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}Foster homes
Add a foster home
Makes a person a foster home. A person can be one foster home only (409 if they are one already). The new home is active. The person’s record is given the foster role if it does not have it already. Needs write on Animals.
POST
/
api
/
animals
/
foster-homes
Add a foster home
curl --request POST \
--url https://{organization}.rescueconsole.com/api/animals/foster-homes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"person_id": "e5b7a1c6-9b8f-4ace-9c5d-7fb0a0ae2c54",
"capacity": 2,
"species_preferences": [
"cat"
],
"accepts_bottle_babies": true,
"approved_on": "2026-09-01",
"notes": "Spare room, no other pets."
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
person_id: 'e5b7a1c6-9b8f-4ace-9c5d-7fb0a0ae2c54',
capacity: 2,
species_preferences: ['cat'],
accepts_bottle_babies: true,
approved_on: '2026-09-01',
notes: 'Spare room, no other pets.'
})
};
fetch('https://{organization}.rescueconsole.com/api/animals/foster-homes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{organization}.rescueconsole.com/api/animals/foster-homes"
payload = {
"person_id": "e5b7a1c6-9b8f-4ace-9c5d-7fb0a0ae2c54",
"capacity": 2,
"species_preferences": ["cat"],
"accepts_bottle_babies": True,
"approved_on": "2026-09-01",
"notes": "Spare room, no other pets."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"foster_home": {
"id": "<string>",
"person_id": "<string>",
"status": "active",
"capacity": 123,
"spots_filled": 123,
"spots_available": 123,
"is_full": true,
"species_preferences": [
"<string>"
],
"accepts_medical": true,
"accepts_bottle_babies": true,
"accepts_behavioral": true,
"approved_on": "<string>",
"notes": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"person": {
"id": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"display_name": "<string>",
"email": "<string>",
"phone": "<string>"
}
}
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}{
"error": "house_trained must be 1, 0 or null (not assessed)"
}Authorizations
An API key from Settings, API keys. It starts with rc_live_.
Body
application/json
A person in your organization who is not a foster home already.
1 unless you say.
Required range:
x >= 1Species keys. Leave it out, or send an empty list, for any.
Only true counts; anything else is false.
Only true counts; anything else is false.
Only true counts; anything else is false.
The day the home was approved (YYYY-MM-DD).
Response
The foster home, as it was created.
Show child attributes
Show child attributes