API Reference

Integrate Paws Source into your applications. Our RESTful API provides programmatic access to pet profiles, veterinary services, grooming bookings, and e-commerce functionality.

https://api.pawssource.com/v2

Authentication

All API requests require authentication via Bearer token. Obtain your API key from the Paws Source Developer Dashboard.

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

Header	Description
`Authorization`	Bearer token for authentication
`X-Client-ID`	Optional: Your registered client identifier

Pet Management

GET /pets List all pets

Returns a paginated list of pets belonging to the authenticated account. Supports filtering by species, breed, and health status.

Parameter	Type	Required	Description
`limit`	integer	No	Number of records (max 100)
`offset`	integer	No	Pagination offset
`species`	string	No	Filter by 'dog', 'cat', 'bird', etc.

Response: 200 OK

{
  "data": [
    {
      "id": "pet_8xK2m9Pq4L",
      "name": "Buster",
      "species": "dog",
      "breed": "Golden Retriever",
      "age_months": 36,
      "health_status": "active"
    }
  ],
  "pagination": {
    "total": 12,
    "limit": 20,
    "offset": 0
  }
}

Status Codes

200Success

401Unauthorized

429Rate limited

POST /pets Register a new pet

Creates a new pet profile and associates it with your account. Triggers automatic health baseline setup.

Request Body

{
  "name": "Luna",
  "species": "cat",
  "breed": "Siamese",
  "birth_date": "2021-08-15",
  "gender": "female",
  "weight_kg": 3.8
}

Response: 201 Created

{
  "success": true,
  "pet": {
    "id": "pet_9mN3v7Rq2W",
    "name": "Luna",
    "created_at": "2025-03-14T10:22:00Z"
  }
}

Veterinary Services

POST /vet/consultations Book a consultation

Schedules a video or in-person veterinary consultation. Requires an active pet profile ID.

Body Parameter	Type	Required	Description
`pet_id`	string	Yes	Registered pet ID
`type`	string	Yes	'video', 'phone', or 'in-person'
`preferred_date`	string	Yes	ISO 8601 date
`symptoms`	string	No	Brief description of concerns

Response: 201 Created

{
  "consultation_id": "vet_5hT8k2Lp9X",
  "status": "confirmed",
  "scheduled_for": "2025-03-18T14:00:00Z",
  "vet_name": "Dr. Sarah Mitchell",
  "join_link": "https://meet.pawssource.com/vet_5hT8k2Lp9X"
}

Orders & Products

GET /orders Retrieve order history

Fetches all placed orders for the authenticated account. Supports filtering by status and date range.

Response: 200 OK

{
  "orders": [
    {
      "order_id": "ord_7jM4p9Qw1Z",
      "status": "delivered",
      "total_cents": 4599,
      "placed_at": "2025-02-10T09:15:00Z",
      "items": [
        { "product": "Premium Grain-Free Dog Food", "qty": 2 }
      ]
    }
  ]
}