Parameters are being used but filtering does not seem to be working
Ensure "ParameterType.RequestBody" is being used for parameters, otherwise they are most likely being send as querystring values.
After including an ID of 4 I get Error converting value 4 to type 'System.Int32[]'
The parameter might be expecting an array instead of a single integer, try converting the integer to an array.
UpdatedSinceUtc must be in the Utc format.
Check out our dates page on how to format dates.
Is there an API that gives us the local time we are connecting to?
This is available in our location endpoint:
api/v2/location/physicallocation/{id}
This has the locations of each shelter, and then a UtcOffset property you can use to find the UTC Time zone.
Why do I receive a credentials don't match a valid user when authenticating?
This can sometimes happen when the username and password is not URL encoded.
How do i get a list of adoptable animals?
All the API endpoints are listed on our Resources page, the endpoint that we suggest to get adoptable animals (or other searching like lost or found or stray etc) would be the POST api/v2/animal/list?page={page}&pageSize={pageSize} endpoint. There is some setup to go along with this using these instructions:
- Setup a search group using the ShelterBuddy application via administration > search group. You will select which statuses / sources you would like included in your search group
- Using the api/v2/animal/list?page={page}&pageSize={pageSize} endpoint you would setup a search model with the following:
- SearchGroupId: this would be from the new search group you set up. To get a list of search groups you can use the
api/v2/animal/searchgroup/list?page={page}&pageSize={pageSize} end point. - UpdatedSinceUTC: This would be to get new animals updated to the search group since you last queried this information.
- SearchGroupId: this would be from the new search group you set up. To get a list of search groups you can use the
- To check if an animal is no longer in the search group you can use the same endpoint but post with the parameter ExcludeSearchGroupId and UpdatedSinceUTC this will get the list of animals taken off the list since a specific date.
How do i get a list of animals in foster that have been microchipped?
Similar to the above adoptable animals, this can be achieved by search groups:
- Using the endpoint api/v2/animal/list?page={page}&pageSize={pageSize} you would setup a search model with the following:
- SearchGroupId: this would be from the new search group we set up called "Animals In Foster". To get a list of search groups you can use the api/v2/animal/searchgroup/list?page={page}&pageSize={pageSize} end point and get the ID from here.
- UpdatedSinceUTC: This would be to get new animals updated to the search group since you last queried this information.
- You would loop through all these pets and check if they have a microchip number, if they do you could enroll them into homesafe under the RSPCA QLD owner.
If the animal then gets adopted, or changes owner through the existing processes these will be picked up through your normal API methods.
How do I get a list of adopted animals?
To get a list of adopted animals you can use StatusHistoryV2 with the property DateRange for the dates you want new adoptions for. You would then populate the Status property with an array of adopted statuses. To get adopted status you use the StatusV2 endpoint and post with the IsAdoption property.
How do I get a list of in care animals?
This can be achieved by first getting a list of in care statuses, then using this list to query animals with that status:
- Using the endpoint api/v2/animal/status/list?page={page}&pageSize={pageSize} you can use the search model with the following to get a list of statusId's for in care statuses:
- "IsInCare": true
- Using the endpoint api/v2/animal/list?page={page}&pageSize={pageSize} you would setup a search model with the following:
- "StatusId": this accepts an array of id's so you can use the list of in care status Id's retrieved in step 1.
- UpdatedSinceUTC: This can be used to get new animals updated since you last queried.
How do I capture pre registrations for adoptions or events?
The api endpoints important for this are:
AcquisitionV2: This is the reason why we are acquiring a person, for example it may just be a General adoption enquiring, or a specific adoption event.
AcquiredPersonV2: This is where you will post new people to based on the form filled out from your website online form.
- AcquisitionId is from the AcquisitionV2 end point and it relates to why you are acquiring the person.
- Appeal category is for fundraising appeal and not usually used.
- Meta Data is a key value pair, for example:
"MetaData": [{key:"MyKey",value:"MyValue"}]
When adding a person via the AcquiredPersonV2 endpoint, they will then show up in a area in shelterbuddy for users to find pre registered people, and then users check if they exist and merge them in or create a new person. From within the ShelterBuddy app, on the main search page there is a link "Pre Registration / Data Acquisition" And then the link for each indivdual acquisition type. This lists all the pre registered people. Once the person is merged or created, then users can process the person (e.g. an adoption) as per normal.
What is the ideal method for accessing photos?
For public sites like an adoptable animal site the photos should be downloaded and cached locally. When polling for animal updates you should re-download photos in case the animal update included a photo change. Photos can be retrieved by using the PhotoV2 endpoint and posting a search model with the animal Id.