> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cuddles.care/llms.txt
> Use this file to discover all available pages before exploring further.

# Cuddles API v1

> Help your pet live a healthy, happy and long life

![Hero Light](https://mintcdn.com/aimythcorp/sJl5mLxCO1SslfXX/images/hero.png?fit=max\&auto=format\&n=sJl5mLxCO1SslfXX\&q=85\&s=f3da1632081efa74b7054e82fb2b677a)

## First steps

In order to integrate with Cuddles, firstly, you need to have a valid account activated with us. Then you can use

> **[Authentication Endpoints](https://docs.cuddles.care/api-reference/authentication/access.md)**
>
> View endpoints

## Pagination

All top-level API resources have support for bulk fetches through “list” API methods. For example, you can list clients, patients, etc. These list API methods share a common structure and accept, at a minimum, the following two parameters: page, limit.
There are optional timestamp parameters for fetching records created or updated between certain date ranges. They are
`createdFrom`, `createdTo` and `updatedFrom`, `updatedTo`

Combination of these optional parameters will fetch records in between two date ranges

> [!NOTE]
>
> The format of the datetime should be ISO 8601 format i.e. `yyyy-MM-ddTHH:mm:ss`.
> The behaviour of query is to perform an **AND** operation between given timestamps

## Authentication

All API endpoints are authenticated using Bearer tokens.

```javascript theme={null}
Bearer <token>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.