Skip to main content
POST
/
v1
/
auth
Obtain an access token
curl --request POST \
  --url https://api.example.com/v1/auth \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": "nc_client_a1b2c3d4e5f6g7h8",
  "client_secret": "nc_secret_x9y8z7w6v5u4t3s2"
}
'
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL25ldXJhY2FsbC5hdXRoMC5jb20vIn0...",
  "expires_at": 1735689600,
  "client_id_audience": "https://api.neuracall.com/call-analysis",
  "scope": "read:call-analysis-requests write:call-analysis-request read:call-analysis-audio read:call-analysis-transcription read:prompt-template write:prompt-template read:call-analysis-stats"
}

Body

application/json

Request body for authentication

​
client_id
string
required

Your application's client ID provided by Neuracall

Example:

"nc_client_a1b2c3d4e5f6g7h8"

​
client_secret
string
required

Your application's client secret. Keep this secure and never expose it publicly

Example:

"nc_secret_x9y8z7w6v5u4t3s2"

Response

Successful Response

Authentication response containing access token and metadata

​
access_token
string
required

JWT access token to include in the Authorization header of subsequent requests

Example:

"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL25ldXJhY2FsbC5hdXRoMC5jb20vIn0..."

​
expires_at
integer
required

Unix timestamp (seconds) when the token expires. Request a new token before this time

Example:

1735689600

​
client_id_audience
string
required

The audience identifier for this token

Example:

"https://api.neuracall.com/call-analysis"

​
scope
string

Space-separated list of granted permission scopes

Example:

"read:call-analysis-requests write:call-analysis-request read:call-analysis-audio"