# Rescuegroups — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for adoptable animals across rescue organizations by species, breed, location, and other criteria, then view detailed profiles with photos and contact information. Find the perfect pet match and connect directly with rescue organizations to start the adoption process.

**Category:** Other | **Website:** [rescuegroups.org/](https://rescuegroups.org/) | **Docs:** [parse.bot/marketplace/d2bf3178-ce8b-44c8-a8a0-09dfefbeb4f0/rescuegroups-org-api](https://parse.bot/marketplace/d2bf3178-ce8b-44c8-a8a0-09dfefbeb4f0/rescuegroups-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rescuegroups-org-api-d2bf3178/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_animal_details

Retrieve full details for a specific animal by ID, including description, organization info, photos, breed, age, sex, status, and location. The animal_id comes from search_available_animals results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `animal_id` | string | Yes | Unique numeric identifier for the animal (from search_available_animals results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rescuegroups-org-api-d2bf3178/get_animal_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"animal_id":"<string>"}'
```

### get_breeds

Retrieve the complete list of valid breed IDs and names that can be used to filter animal searches via the breed parameter on search_available_animals.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rescuegroups-org-api-d2bf3178/get_breeds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_available_animals

Search for available/adoptable animals with filters for breed, sex, location, and distance. Can filter for animals needing foster care. Returns paginated results with animal summaries including name, breed, basic info, distance, and photo. Each result carries an animal ID suitable for get_animal_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `breed` | string | No | Breed ID to filter by (use get_breeds endpoint to retrieve valid IDs). |
| `distance` | integer | No | Search radius in miles from the specified location. |
| `location` | string | No | ZIP/Postal code to search near. |
| `needs_foster` | boolean | No | When true, filters for animals needing foster homes only. |
| `page` | integer | No | Page number of results. |
| `sex` | string | No | Sex of the animal: Male, Female, or omit for either. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rescuegroups-org-api-d2bf3178/search_available_animals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"breed":"<string>","distance":"<integer>","location":"<string>","needs_foster":"<boolean>","page":"<integer>","sex":"<string>"}'
```