curl https://portal.bridgelinepf.com/api/v1/whoami \
-H "Authorization: Bearer $BRIDGELINE_API_KEY"
const res = await fetch('https://portal.bridgelinepf.com/api/v1/whoami', {
headers: {
Authorization: `Bearer ${process.env.BRIDGELINE_API_KEY}`,
},
})
const data = await res.json()
import os
import requests
res = requests.get(
"https://portal.bridgelinepf.com/api/v1/whoami",
headers={
"Authorization": f"Bearer {os.environ['BRIDGELINE_API_KEY']}",
},
timeout=30,
)
data = res.json()
{
"object": "whoami",
"livemode": true,
"brokerage": {"name": "Lone Star Risk Partners"},
"acting_broker": {"email": "maria@lonestarrisk.example", "name": "Maria Delgado"},
"api_key": {
"type": "agency",
"scopes": ["quotes:read", "quotes:write"]
},
"api_version": "2026-09-23"
}
{
"error": {
"type": "permission",
"code": "API_ACCESS_NOT_ENABLED",
"message": "API access is not enabled for this agency. Contact Bridgeline.",
"doc_url": "https://docs.bridgelinepf.com/errors#API_ACCESS_NOT_ENABLED",
"request_id": "req_8fJ2kQ9xLm4TzW7nB3cY5pDv"
}
}
Keys
Introspect the calling API key
Returns the agency, the key’s default broker (the broker every request acts as unless a write names another with broker_email in its body), scopes and mode. Requires no scope; use it to verify a key.
GET
/
v1
/
whoami
curl https://portal.bridgelinepf.com/api/v1/whoami \
-H "Authorization: Bearer $BRIDGELINE_API_KEY"
const res = await fetch('https://portal.bridgelinepf.com/api/v1/whoami', {
headers: {
Authorization: `Bearer ${process.env.BRIDGELINE_API_KEY}`,
},
})
const data = await res.json()
import os
import requests
res = requests.get(
"https://portal.bridgelinepf.com/api/v1/whoami",
headers={
"Authorization": f"Bearer {os.environ['BRIDGELINE_API_KEY']}",
},
timeout=30,
)
data = res.json()
{
"object": "whoami",
"livemode": true,
"brokerage": {"name": "Lone Star Risk Partners"},
"acting_broker": {"email": "maria@lonestarrisk.example", "name": "Maria Delgado"},
"api_key": {
"type": "agency",
"scopes": ["quotes:read", "quotes:write"]
},
"api_version": "2026-09-23"
}
{
"error": {
"type": "permission",
"code": "API_ACCESS_NOT_ENABLED",
"message": "API access is not enabled for this agency. Contact Bridgeline.",
"doc_url": "https://docs.bridgelinepf.com/errors#API_ACCESS_NOT_ENABLED",
"request_id": "req_8fJ2kQ9xLm4TzW7nB3cY5pDv"
}
}
Use it to confirm a new key works, and to see which agency it belongs to, which broker it acts as by default, its type and scopes, and its mode. See authentication.
curl https://portal.bridgelinepf.com/api/v1/whoami \
-H "Authorization: Bearer $BRIDGELINE_API_KEY"
const res = await fetch('https://portal.bridgelinepf.com/api/v1/whoami', {
headers: {
Authorization: `Bearer ${process.env.BRIDGELINE_API_KEY}`,
},
})
const data = await res.json()
import os
import requests
res = requests.get(
"https://portal.bridgelinepf.com/api/v1/whoami",
headers={
"Authorization": f"Bearer {os.environ['BRIDGELINE_API_KEY']}",
},
timeout=30,
)
data = res.json()
{
"object": "whoami",
"livemode": true,
"brokerage": {"name": "Lone Star Risk Partners"},
"acting_broker": {"email": "maria@lonestarrisk.example", "name": "Maria Delgado"},
"api_key": {
"type": "agency",
"scopes": ["quotes:read", "quotes:write"]
},
"api_version": "2026-09-23"
}
{
"error": {
"type": "permission",
"code": "API_ACCESS_NOT_ENABLED",
"message": "API access is not enabled for this agency. Contact Bridgeline.",
"doc_url": "https://docs.bridgelinepf.com/errors#API_ACCESS_NOT_ENABLED",
"request_id": "req_8fJ2kQ9xLm4TzW7nB3cY5pDv"
}
}
Authorizations
bl_live_… or bl_test_… API key.
Headers
API version (a date). Defaults to 2026-09-23; echoed on every response.
Pattern:
^\d{4}-\d{2}-\d{2}$Response
The principal summary.
Who the calling API key acts as.
Allowed value:
"whoami"false for bl_test_ keys.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The resolved Bridgeline-Version for this request.