---
title: "Show Doctor's Availability"
description: "Find available timeslots for booking by listing care units, resources, healthcare services, and open time windows."
canonical_url: "http://localhost/api/quickstart/show-availability"
---
# Show Doctor's Availability

> Find available timeslots for booking by listing care units, resources, healthcare services, and open time windows.

Learn how to discover available timeslots for booking appointments. This guide walks through the complete flow from finding care units to checking doctor availability.

<u-alert color="primary" variant="subtle" icon="heroicons:key">
<template v-slot:description="">

Start with this guide in all quickstart flows. `care_unit_id` from step 1 is required in all subsequent API calls. You will also reuse `resource_id`, `healthcare_service_id`, and `timeslots` in later guides.

</template>
</u-alert>

## Flow Overview

![Show Doctor's Availability Flow](http://localhost/images/quickstart/show-availability.png)

## Understanding the Concepts

Before diving into code, let's understand the key concepts:

- **Care Units**: Physical locations where healthcare is provided (e.g., "Main Clinic", "Downtown Office")
- **Resources**: People or equipment that can be scheduled (e.g., "Dr. Smith", "MRI Machine")
- **Healthcare Services**: Types of appointments offered (e.g., "General Consultation", "Follow-up Visit")
- **Timeslots**: Available time windows when a resource can be booked

## Code Example

<u-collapsible>
<u-button className="mb-4" color="neutral" label="View full example" trailing-icon="i-heroicons-code-bracket-16-solid" variant="subtle">



</u-button>

<template v-slot:content="">
<code-lang-tabs>
<template v-slot:python="">

```python
import requests
from datetime import datetime, timedelta
from zoneinfo import ZoneInfo

CLIENT_ID = "your-client-id"
CLIENT_SECRET = "your-client-secret"
BASE_URL = "https://api.leyr.io/api"
EMR = "webdoc"

headers = {
    "x-leyr-client-id": CLIENT_ID,
    "x-leyr-client-secret": CLIENT_SECRET,
    "Content-Type": "application/json"
}

# 1. Get care units
response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units",
    headers=headers
)
care_units = response.json()

care_unit = care_units[0]
care_unit_id = care_unit["id"]

# 2. Get resources
response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units/{care_unit_id}/resources",
    headers=headers
)
resources = response.json()

doctor = resources[0]
resource_id = doctor["id"]

# 3. Get healthcare services
response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units/{care_unit_id}/healthcare-services",
    headers=headers
)
services = response.json()

service = services[0]
service_id = service["id"]

# 4. Get available timeslots
start = datetime.now(tz=ZoneInfo("Europe/Stockholm")).isoformat()
end = (datetime.now(tz=ZoneInfo("Europe/Stockholm")) + timedelta(days=30)).isoformat()

response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units/{care_unit_id}/timeslots",
    headers=headers,
    params={
        "start": start,
        "end": end,
        # "resource_id": resource_id,  # Add filters as needed
        # "healthcare_service_id": service_id  # Add filters as needed
    }
)
timeslots = response.json()

# 5. Display a few results
print(f"Found {len(timeslots)} timeslots. First 5:")
for slot in timeslots[:5]:
    print(f"- {slot['start']}")
```

</template>

<template v-slot:javascript="">

```javascript
const CLIENT_ID = "your-client-id";
const CLIENT_SECRET = "your-client-secret";
const BASE_URL = "https://api.leyr.io/api";
const EMR = "webdoc";

const headers = {
  "x-leyr-client-id": CLIENT_ID,
  "x-leyr-client-secret": CLIENT_SECRET,
  "Content-Type": "application/json"
};

// 1. Get care units
let response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units`,
  { headers }
);
const careUnits = await response.json();

const careUnit = careUnits[0];
const careUnitId = careUnit.id;

// 2. Get resources
response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units/${careUnitId}/resources`,
  { headers }
);
const resources = await response.json();

const doctor = resources[0];
const resourceId = doctor.id;

// 3. Get healthcare services
response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units/${careUnitId}/healthcare-services`,
  { headers }
);
const services = await response.json();

const service = services[0];
const serviceId = service.id;

// 4. Get available timeslots
const start = new Date().toISOString();
const end = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString();

const params = new URLSearchParams({
  start,
  end,
  // resource_id: resourceId, // Add filters as needed
  // healthcare_service_id: serviceId // Add filters as needed
});

response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units/${careUnitId}/timeslots?${params}`,
  { headers }
);
const timeslots = await response.json();

// 5. Display a few results
console.log(`Found ${timeslots.length} timeslots. First 5:`);
timeslots.slice(0, 5).forEach(slot => {
  console.log(`- ${slot.start}`);
});
```

</template>
</code-lang-tabs>
</template>
</u-collapsible>

### Shared setup

<code-lang-tabs :items="[{"label":"Python","icon":"i-vscode-icons-file-type-python","slot":"python"},{"label":"JavaScript","icon":"i-vscode-icons-file-type-js-official","slot":"javascript"}]">
<template v-slot:python="">

```python
import requests
from datetime import datetime, timedelta
from zoneinfo import ZoneInfo

CLIENT_ID = "your-client-id"
CLIENT_SECRET = "your-client-secret"
BASE_URL = "https://api.leyr.io/api"
EMR = "webdoc"

headers = {
    "x-leyr-client-id": CLIENT_ID,
    "x-leyr-client-secret": CLIENT_SECRET,
    "Content-Type": "application/json"
}
```

</template>

<template v-slot:javascript="">

```javascript
const CLIENT_ID = "your-client-id";
const CLIENT_SECRET = "your-client-secret";
const BASE_URL = "https://api.leyr.io/api";
const EMR = "webdoc";

const headers = {
  "x-leyr-client-id": CLIENT_ID,
  "x-leyr-client-secret": CLIENT_SECRET,
  "Content-Type": "application/json"
};
```

</template>
</code-lang-tabs>

#### 1. Get care units

<code-lang-tabs :items="[{"label":"Python","icon":"i-vscode-icons-file-type-python","slot":"python"},{"label":"JavaScript","icon":"i-vscode-icons-file-type-js-official","slot":"javascript"}]">
<template v-slot:python="">

```python
response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units",
    headers=headers
)
care_units = response.json()

care_unit = care_units[0]
care_unit_id = care_unit["id"]
```

</template>

<template v-slot:javascript="">

```javascript
let response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units`,
  { headers }
);
const careUnits = await response.json();

const careUnit = careUnits[0];
const careUnitId = careUnit.id;
```

</template>
</code-lang-tabs>

#### 2. Get resources

<code-lang-tabs :items="[{"label":"Python","icon":"i-vscode-icons-file-type-python","slot":"python"},{"label":"JavaScript","icon":"i-vscode-icons-file-type-js-official","slot":"javascript"}]">
<template v-slot:python="">

```python
response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units/{care_unit_id}/resources",
    headers=headers
)
resources = response.json()

doctor = resources[0]
resource_id = doctor["id"]
```

</template>

<template v-slot:javascript="">

```javascript
response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units/${careUnitId}/resources`,
  { headers }
);
const resources = await response.json();

const doctor = resources[0];
const resourceId = doctor.id;
```

</template>
</code-lang-tabs>

#### 3. Get healthcare services

<code-lang-tabs :items="[{"label":"Python","icon":"i-vscode-icons-file-type-python","slot":"python"},{"label":"JavaScript","icon":"i-vscode-icons-file-type-js-official","slot":"javascript"}]">
<template v-slot:python="">

```python
response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units/{care_unit_id}/healthcare-services",
    headers=headers
)
services = response.json()

service = services[0]
service_id = service["id"]
```

</template>

<template v-slot:javascript="">

```javascript
response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units/${careUnitId}/healthcare-services`,
  { headers }
);
const services = await response.json();

const service = services[0];
const serviceId = service.id;
```

</template>
</code-lang-tabs>

#### 4. Get available timeslots

<code-lang-tabs :items="[{"label":"Python","icon":"i-vscode-icons-file-type-python","slot":"python"},{"label":"JavaScript","icon":"i-vscode-icons-file-type-js-official","slot":"javascript"}]">
<template v-slot:python="">

```python
start = datetime.now(tz=ZoneInfo("Europe/Stockholm")).isoformat()
end = (datetime.now(tz=ZoneInfo("Europe/Stockholm")) + timedelta(days=30)).isoformat()

response = requests.get(
    f"{BASE_URL}/emrs/{EMR}/care-units/{care_unit_id}/timeslots",
    headers=headers,
    params={
        "start": start,
        "end": end,
        # "resource_id": resource_id,  # Add filters as needed
        # "healthcare_service_id": service_id  # Add filters as needed
    }
)
timeslots = response.json()
```

</template>

<template v-slot:javascript="">

```javascript
const start = new Date().toISOString();
const end = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString();

const params = new URLSearchParams({
  start,
  end,
  // resource_id: resourceId, // Add filters as needed
  // healthcare_service_id: serviceId // Add filters as needed
});

response = await fetch(
  `${BASE_URL}/emrs/${EMR}/care-units/${careUnitId}/timeslots?${params}`,
  { headers }
);
const timeslots = await response.json();
```

</template>
</code-lang-tabs>

#### 5. Display a few results

<code-lang-tabs :items="[{"label":"Python","icon":"i-vscode-icons-file-type-python","slot":"python"},{"label":"JavaScript","icon":"i-vscode-icons-file-type-js-official","slot":"javascript"}]">
<template v-slot:python="">

```python
print(f"Found {len(timeslots)} timeslots. First 5:")
for slot in timeslots[:5]:
    print(f"- {slot['start']}")
```

</template>

<template v-slot:javascript="">

```javascript
console.log(`Found ${timeslots.length} timeslots. First 5:`);
timeslots.slice(0, 5).forEach(slot => {
  console.log(`- ${slot.start}`);
});
```

</template>
</code-lang-tabs>

## Key Insights

### Working with IDs

Leyr uses two types of identifiers throughout the API:

- **id** - Leyr's internal identifier. **Always use this for API requests** (booking appointments, filtering timeslots, etc.)
- **emr_id** - The original EHR system's identifier. This is provided for informational purposes and debugging with the EHR, but should not be used in Leyr API calls

For example, when booking an appointment, use `resource.id` and `service.id`, not `resource.emr_id`.

<u-alert color="primary" variant="subtle">
<template v-slot:description="">

**Date Format:** All datetime values use ISO 8601 format (e.g., `2024-03-22T14:30:00+01:00`). Make sure to URL-encode these values when passing as query parameters.

</template>
</u-alert>

## Filtering Results

You can filter timeslots by resource, service, or both:

<code-lang-tabs :items="[{"label":"Python","icon":"i-vscode-icons-file-type-python","slot":"python"},{"label":"JavaScript","icon":"i-vscode-icons-file-type-js-official","slot":"javascript"}]">
<template v-slot:python="">

```python
# Get timeslots for a specific doctor only
params = {
    "start": start,
    "end": end,
    "resource_id": resource_id  # Filter by doctor
}

# Get timeslots for a specific service only
params = {
    "start": start,
    "end": end,
    "healthcare_service_id": service_id  # Filter by service type
}

# Get timeslots for specific doctor AND service
params = {
    "start": start,
    "end": end,
    "resource_id": resource_id,
    "healthcare_service_id": service_id
}
```

</template>

<template v-slot:javascript="">

```javascript
// Get timeslots for a specific doctor only
const params = new URLSearchParams({
  start,
  end,
  resource_id: resourceId  // Filter by doctor
});

// Get timeslots for a specific service only
const params = new URLSearchParams({
  start,
  end,
  healthcare_service_id: serviceId  // Filter by service type
});

// Get timeslots for specific doctor AND service
const params = new URLSearchParams({
  start,
  end,
  resource_id: resourceId,
  healthcare_service_id: serviceId
});
```

</template>
</code-lang-tabs>

## Next steps

<card-group>
<card icon="i-heroicons-calendar-days" title="Book an Appointment" to="http://localhost/api/quickstart/book-appointment">

Create appointments using a found timeslot and a patient.

</card>
</card-group>

## API Reference

For detailed API documentation, see:

- [Care Units API](https://api.leyr.io/docs#tag/Care-Units)
- [Resources API](https://api.leyr.io/docs#tag/Resources)
- [Healthcare Services API](https://api.leyr.io/docs#tag/Healthcare-Services)
- [Timeslots API](https://api.leyr.io/docs#tag/Timeslots)


## Sitemap

See the full [sitemap](http://localhost/sitemap.md) for all pages.