5-minute guide

First API Call in 5 Minutes

Go from zero to a working Talon API integration in four steps.

1

Create your account

Sign up for a free account. No credit card required — you get free API calls every month.

Create Account
2

Generate an API key

From your dashboard, click Create API Key. You'll see your full key once — copy it immediately.

Your new API key:
tln_test_a3xK9mP2vL8qR5nT1wY4bC7...

Keys starting with tln_test_ are sandbox keys. They return realistic fake data and never charge credits — perfect for development.

3

Make your first call

Look up Aetna's requirements for a total knee replacement (CPT 27447):

curl
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://talonapi.dev/api/v1/rules?payer=aetna&cpt=27447"
JavaScript
const response = await fetch(
  "https://talonapi.dev/api/v1/rules?payer=aetna&cpt=27447",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await response.json();
console.log(data);
Python
import requests

response = requests.get(
    "https://talonapi.dev/api/v1/rules",
    params={"payer": "aetna", "cpt": "27447"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

You should see the full payer requirements including approval rates, documentation rules, and denial patterns.

Or try it right now in the API Playground — no code required.

4

Check your usage

Head to your dashboard to see:

  • Total API calls and calls by endpoint
  • Credits remaining (sandbox calls are free)
  • Response latency and error rates

When you're ready for production, create a tln_live_ key and purchase credits.