Search My Spend Usage

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "appId": "<string>",
  "endTime": "2023-11-07T05:31:56Z",
  "pageSize": 123,
  "pageToken": "<string>",
  "startTime": "2023-11-07T05:31:56Z"
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search"

payload = {
    "appId": "<string>",
    "endTime": "2023-11-07T05:31:56Z",
    "pageSize": 123,
    "pageToken": "<string>",
    "startTime": "2023-11-07T05:31:56Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    appId: '<string>',
    endTime: '2023-11-07T05:31:56Z',
    pageSize: 123,
    pageToken: '<string>',
    startTime: '2023-11-07T05:31:56Z'
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'appId' => '<string>',
    'endTime' => '2023-11-07T05:31:56Z',
    'pageSize' => 123,
    'pageToken' => '<string>',
    'startTime' => '2023-11-07T05:31:56Z'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search"

	payload := strings.NewReader("{\n  \"appId\": \"<string>\",\n  \"endTime\": \"2023-11-07T05:31:56Z\",\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"appId\": \"<string>\",\n  \"endTime\": \"2023-11-07T05:31:56Z\",\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"appId\": \"<string>\",\n  \"endTime\": \"2023-11-07T05:31:56Z\",\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\"\n}"

response = http.request(request)
puts response.read_body

{
  "list": [
    {
      "appId": "<string>",
      "cacheReadTokens": "<string>",
      "cacheWriteTokens": "<string>",
      "conversationId": "<string>",
      "costNano": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "currencyCode": "<string>",
      "finalizedAt": "2023-11-07T05:31:56Z",
      "inputTokens": "<string>",
      "modelId": "<string>",
      "outcome": "MY_SPEND_USAGE_OUTCOME_UNSPECIFIED",
      "outputTokens": "<string>",
      "reasoningTokens": "<string>",
      "usageId": "<string>",
      "usageIncomplete": true
    }
  ],
  "nextPageToken": "<string>"
}

POST

api

spend-insights

usage

Search My Spend Usage

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "appId": "<string>",
  "endTime": "2023-11-07T05:31:56Z",
  "pageSize": 123,
  "pageToken": "<string>",
  "startTime": "2023-11-07T05:31:56Z"
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search"

payload = {
    "appId": "<string>",
    "endTime": "2023-11-07T05:31:56Z",
    "pageSize": 123,
    "pageToken": "<string>",
    "startTime": "2023-11-07T05:31:56Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    appId: '<string>',
    endTime: '2023-11-07T05:31:56Z',
    pageSize: 123,
    pageToken: '<string>',
    startTime: '2023-11-07T05:31:56Z'
  })
};

fetch('https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'appId' => '<string>',
    'endTime' => '2023-11-07T05:31:56Z',
    'pageSize' => 123,
    'pageToken' => '<string>',
    'startTime' => '2023-11-07T05:31:56Z'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search"

	payload := strings.NewReader("{\n  \"appId\": \"<string>\",\n  \"endTime\": \"2023-11-07T05:31:56Z\",\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"appId\": \"<string>\",\n  \"endTime\": \"2023-11-07T05:31:56Z\",\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/spend-insights/my/usage/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"appId\": \"<string>\",\n  \"endTime\": \"2023-11-07T05:31:56Z\",\n  \"pageSize\": 123,\n  \"pageToken\": \"<string>\",\n  \"startTime\": \"2023-11-07T05:31:56Z\"\n}"

response = http.request(request)
puts response.read_body

{
  "list": [
    {
      "appId": "<string>",
      "cacheReadTokens": "<string>",
      "cacheWriteTokens": "<string>",
      "conversationId": "<string>",
      "costNano": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "currencyCode": "<string>",
      "finalizedAt": "2023-11-07T05:31:56Z",
      "inputTokens": "<string>",
      "modelId": "<string>",
      "outcome": "MY_SPEND_USAGE_OUTCOME_UNSPECIFIED",
      "outputTokens": "<string>",
      "reasoningTokens": "<string>",
      "usageId": "<string>",
      "usageIncomplete": true
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization

string

header

required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

SearchMySpendUsageRequest selects a half-open finalization-time interval. The caller's identity is always obtained from the authenticated session. Bounds must have microsecond precision; finer timestamps are rejected.

appId

string

Optional application filter; does not grant access to another user's calls.

endTime

string<date-time> | null

pageSize

integer<int32>

Maximum rows per page. Zero uses the server default.

pageToken

string

Opaque position token from a previous response. Keep history selectors unchanged when continuing; concurrent writes may shift page boundaries. Caller authorization is applied independently on every request.

startTime

string<date-time> | null

Response

200 - application/json

SearchMySpendUsageResponse contains one page of caller-only usage.

list

My Spend Usage Row · object[] | null

The list field.

Show child attributes

nextPageToken

string

The nextPageToken field.

Welcome

Endpoints

Search My Spend Usage

Authorizations

Body

Response