Get Started with the TeamCare Vendor API

This guide walks you through the steps to create your TeamCare vendor account, generate API credentials, and make your first authenticated request to the Vendor API.

Visit the TeamCare production environment at https://app.teamcaredental.com and register your consulting firm (also referred to as your vendor or agency account).

Add practices under your account

After registration, add the dental practices (organizations) you want to access. Each practice can have multiple locations, and data is stored per location.

Accept the API agreement and generate API keys

Go to Settings > Company > Agreement and accept the Developer API Agreement (only the account owner can do this).
Go to Settings > Company > API Access and generate your API keys.
Copy your client_id and client_secret. The secret is shown only once. If you regenerate keys, the old ones are immediately invalidated.

Get a Bearer Token

Exchange your credentials for a JWT Bearer Token by sending a POST request to the authentication endpoint.

curl -X POST "https://app.teamcaredental.com/api/v1/vendors/auth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

import requests

response = requests.post(
    "https://app.teamcaredental.com/api/v1/vendors/auth/token",
    json={
        "client_id": "YOUR_CLIENT_ID",
        "client_secret": "YOUR_CLIENT_SECRET"
    }
)
token = response.json()["token"]

The response looks like this:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

The token is valid for 6 hours. Cache it and reuse it until it expires. Do not request a new token for every API call.

Make your first request

Use your Bearer Token to call the organizations endpoint and list the practices associated with your account.

curl -X GET "https://app.teamcaredental.com/api/v1/vendors/organizations" \
  -H "Authorization: Bearer YOUR_TOKEN"

import requests

headers = {"Authorization": "Bearer YOUR_TOKEN"}
response = requests.get(
    "https://app.teamcaredental.com/api/v1/vendors/organizations",
    headers=headers
)
print(response.json())

Example response:

{
  "data": [
    {
      "id": "org_123",
      "name": "Bright Smile Dental Group",
      "created_at": "2024-01-15T09:30:00Z"
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

The token endpoint has its own rate limit: 10 requests per minute per IP. If you request a token on every API call, you will quickly exhaust this budget and receive 429 errors.

Next steps

Authentication

Dive deeper into key generation, token handling, and best practices.

API Reference

Explore all available endpoints for patients, appointments, treatments, and more.

⌘I

Get Started

Core Concepts

Resources

Get Started with the TeamCare Vendor API

Next steps

Authentication

API Reference

​Next steps

Authentication

API Reference

Next steps