get__aistats_minute

GET /aistats/minute

Get Minute-Level AI Statistics

Get minute-level aggregated AI statistics for LLM usage, including token counts, API calls, policy violations, and performance metrics. This endpoint provides more granular data than the daily endpoint.

Parameters

Name

Type

Required

Description

startDate

query

string(date)

false

Start date (ISO format)

endDate

query

string(date)

false

End date (ISO format)

repoId

query

string

false

Repository ID filter (comma-separated for multiple values)

aiLlmId

query

string

false

AI LLM ID filter (comma-separated for multiple values)

repoAiApiKeyId

query

string

false

Repository AI API Key ID filter (comma-separated for multiple values)

hosts

query

string

false

Host filter (comma-separated for multiple values)

llmType

query

string

false

LLM type filter (comma-separated for multiple values, e.g., "OPENAI", "ANTHROPIC")

llmModel

query

string

false

LLM model filter (comma-separated for multiple values, e.g., "gpt-4", "claude-3")

Note: When multiple filter parameters (repoId, aiLlmId, repoAiApiKeyId) are provided, they are combined using OR logic. The hosts filter uses AND logic with other filters.

TypeScript Client Library

// Using the Flashback TypeScript client
import { FlashbackClient } from '@flashbacktech/flashbackclient';

const client = new FlashbackClient({
  accessToken: 'your-access-token'
});

// Get minute-level AI statistics with optional filters
try {
  const result = await client.getAiStatsMinute({
    startDate: new Date('2024-01-01'),
    endDate: new Date('2024-01-01T23:59:59'),
    repoId: ['repo-id-1', 'repo-id-2'],
    aiLlmId: ['llm-id-1'],
    repoAiApiKeyId: ['api-key-id-1'],
    hosts: ['host1.example.com', 'host2.example.com'],
    llmType: ['OPENAI', 'ANTHROPIC'],
    llmModel: ['gpt-4', 'claude-3']
  });
  console.log('Minute-level AI statistics:', result);
} catch (error) {
  console.error('Failed to retrieve minute-level AI statistics:', error);
}

Code Samples

# You can also use wget
curl -X GET "https://backend.flashback.tech/aistats/minute?startDate=2024-01-01T00:00:00.000Z&endDate=2024-01-01T23:59:59.999Z&repoId=repo-id-1,repo-id-2" \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET https://backend.flashback.tech/aistats/minute?startDate=2024-01-01T00:00:00.000Z&endDate=2024-01-01T23:59:59.999Z HTTP/1.1
Host: backend.flashback.tech
Accept: application/json
Authorization: Bearer {access-token}

const headers = {
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

const queryParams = new URLSearchParams({
  startDate: '2024-01-01T00:00:00.000Z',
  endDate: '2024-01-01T23:59:59.999Z',
  repoId: 'repo-id-1,repo-id-2'
});

fetch(`https://backend.flashback.tech/aistats/minute?${queryParams.toString()}`,
{
  method: 'GET',
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.get 'https://backend.flashback.tech/aistats/minute',
  params: {
    startDate: '2024-01-01T00:00:00.000Z',
    endDate: '2024-01-01T23:59:59.999Z',
    repoId: 'repo-id-1,repo-id-2'
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

params = {
  'startDate': '2024-01-01T00:00:00.000Z',
  'endDate': '2024-01-01T23:59:59.999Z',
  'repoId': 'repo-id-1,repo-id-2'
}

r = requests.get('https://backend.flashback.tech/aistats/minute', headers=headers, params=params)

print(r.json())

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

$queryParams = array(
    'startDate' => '2024-01-01T00:00:00.000Z',
    'endDate' => '2024-01-01T23:59:59.999Z',
    'repoId' => 'repo-id-1,repo-id-2'
);

try {
    $response = $client->request('GET','https://backend.flashback.tech/aistats/minute', array(
        'headers' => $headers,
        'query' => $queryParams,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

import java.net.URLEncoder;
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

String baseUrl = "https://backend.flashback.tech/aistats/minute";
String queryString = "startDate=2024-01-01T00:00:00.000Z&endDate=2024-01-01T23:59:59.999Z&repoId=repo-id-1,repo-id-2";
URL obj = new URL(baseUrl + "?" + queryString);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
con.setRequestProperty("Accept", "application/json");
con.setRequestProperty("Authorization", "Bearer {access-token}");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
       "net/url"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    params := url.Values{}
    params.Add("startDate", "2024-01-01T00:00:00.000Z")
    params.Add("endDate", "2024-01-01T23:59:59.999Z")
    params.Add("repoId", "repo-id-1,repo-id-2")

    req, err := http.NewRequest("GET", "https://backend.flashback.tech/aistats/minute?" + params.Encode(), nil)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Example responses

200 Response

{
  "success": true,
  "data": [
    {
      "timestamp": 1704067200,
      "repoId": "repo-id-1",
      "aiLlmId": "llm-id-1",
      "repoAiApiKeyId": "api-key-id-1",
      "tokensIn": "1500",
      "tokensOut": "800",
      "llmTokensIn": "1500",
      "llmTokensOut": "800",
      "activeConversations": 5,
      "apiCalls": 25,
      "policyViolations": 2,
      "numAlerts": 1,
      "numBlocks": 0,
      "numSeverityLow": 0,
      "numSeverityMedium": 1,
      "numSeverityHigh": 1,
      "latency_ms": 250,
      "llmType": "openai",
      "llmModel": "gpt-4",
      "host": "api.openai.com"
    }
  ]
}

Responses

Status

Meaning

Description

Schema

200

Minute-level AI statistics

Inline

400

Bad Request

Invalid request parameters

Inline

404

Not Found

User not found

Inline

500

Internal Server Error

Internal server error

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

» success

boolean

true

none

Indicates if the request was successful

» data

[object]

true

none

Array of minute-level AI statistics records

»» timestamp

integer

true

none

Unix timestamp (seconds) for the statistics record

»» repoId

string

true

none

Repository ID

»» aiLlmId

string

true

none

AI LLM ID

»» repoAiApiKeyId

string

true

none

Repository AI API Key ID

»» tokensIn

string

true

none

Total input tokens (as string to handle large numbers)

»» tokensOut

string

true

none

Total output tokens (as string to handle large numbers)

»» llmTokensIn

string

true

none

LLM input tokens (as string to handle large numbers)

»» llmTokensOut

string

true

none

LLM output tokens (as string to handle large numbers)

»» activeConversations

integer

true

none

Number of active conversations

»» apiCalls

integer

true

none

Number of API calls

»» policyViolations

integer

true

none

Number of policy violations

»» numAlerts

integer

true

none

Number of alerts triggered

»» numBlocks

integer

true

none

Number of blocked requests

»» numSeverityLow

integer

true

none

Number of policy violations with LOW severity

»» numSeverityMedium

integer

true

none

Number of policy violations with MEDIUM severity

»» numSeverityHigh

integer

true

none

Number of policy violations with HIGH severity

»» latency_ms

number

true

none

Average latency in milliseconds

»» llmType

string

true

none

Type of LLM provider (e.g., "openai", "anthropic")

»» llmModel

string

true

none

LLM model name (e.g., "gpt-4", "claude-3")

»» host

string

true

none

Host/domain of the LLM API endpoint

Status Code 400

Name

Type

Required

Restrictions

Description

» success

boolean

true

none

Always false for error responses

» message

string

true

none

Error message

Status Code 404

Name

Type

Required

Restrictions

Description

» success

boolean

true

none

Always false for error responses

» message

string

true

none

Error message

Status Code 500

Name

Type

Required

Restrictions

Description

» success

boolean

true

none

Always false for error responses

» message

string

true

none

Error message

Previousget__aistats_daily NextAdditional Services

Last updated 1 day ago

Was this helpful?

hashtagParameters

hashtagTypeScript Client Library

hashtagCode Samples

hashtagResponses

hashtagResponse Schema

Parameters

TypeScript Client Library

Code Samples

Responses

Response Schema