Fetching Pets via API

The PawPlacer API allows you to retrieve pet profiles and their related data. This enables external systems to access up-to-date information about available pets and their medical history.

Note: This feature is in beta and may be subject to changes. DO NOT use this feature in production environments until it is officially released. Please contact us with any feedback or issues.

If you would rather embed a full-feature widget for your organization and pets, you can use the widget instead.

Endpoint

GET /api/pets

Authentication

All API requests require an API key, which can be retrieved from your account settings. Include the API key in the request headers as follows:

"x-api-key": process.env.PAWPLACER_API_KEY

Example

async function fetchPets() {
  try {
    const response = await fetch("https://pawplacer.com/api/pets", {
      headers: {
        "x-api-key": process.env.PAWPLACER_API_KEY
      }
    });

    if (!response.ok) {
      throw new Error('Failed to fetch pets');
    }

    return await response.json();
  } catch (error) {
    console.error('Error:', error);
  }
}

Response Format

A successful request returns a JSON object containing an array of pet profiles with the following fields.

Fields

Types

General

Note

Exam

Vaccination

Procedure

Error Handling

Best Practices

• Keep API keys secure and do not expose them publicly
• Make requests efficiently to avoid rate limiting
• Keep data in sync with your application by updating records periodically