Authenticate with the TeamCare Vendor API

TeamCare Vendor API uses API key pairs and short-lived JWT Bearer Tokens for authentication. You generate keys from the TeamCare dashboard, exchange them for a token, and include that token in the Authorization header of every request.

Getting your API keys

Before you can call the API, you must generate credentials from the TeamCare web application:

Log in to app.teamcaredental.com.
Navigate to Settings > Company > Agreement and accept the Developer API Agreement. Only the account owner can perform this step.
Go to Settings > Company > API Access and generate your API keys.
Copy your client_id and client_secret. The secret is shown once and cannot be retrieved again.

Never share your API keys. The client_secret is displayed only once when generated. If you regenerate keys, the previous credentials are immediately invalidated.

Requesting a token

To obtain a Bearer Token, send your client_id and client_secret to the token 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"]

Request parameters

string

required

Your API client identifier, generated in the dashboard.

string

required

Your API client secret, shown once during key generation.

Response fields

string

A JWT Bearer Token valid for 6 hours. Include this in the Authorization: Bearer <token> header on all subsequent requests.

Example response:

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

Using the token

Include the token in the Authorization header of every request to protected endpoints.

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())

Cache your token and reuse it for the full 6 hour lifetime. Calling the token endpoint for every request will exhaust the 10 requests per minute per IP limit and cause avoidable 429 errors.

Token expiry

Tokens expire after 6 hours. When a token expires, requests will return a 401 Unauthorized error. Re-request a token using the same client_id and client_secret, then update the Authorization header in your application. There is no refresh token flow. Simply call the token endpoint again with your original credentials to receive a new Bearer Token.

Get Started

Core Concepts

Resources

Authenticate with the TeamCare Vendor API

Getting your API keys

Requesting a token

Request parameters

Response fields

Using the token

Token expiry

​Getting your API keys

​Requesting a token

​Request parameters

​Response fields

​Using the token

​Token expiry

Getting your API keys

Requesting a token

Request parameters

Response fields

Using the token

Token expiry