Skip to main content
GET
https://api.evergreens.ai
/
v1
/
observations
List observations
curl --request GET \
  --url https://api.evergreens.ai/v1/observations \
  --header 'Authorization: Bearer <token>'
{
  id: string;
  api_key_id: string;
  ip: string;
  user_agent: string;
  http_status: number;
  method: string;
  path: string;
  status: "success" | "error";
  metadata?: {
    request: {
      headers: Record<string, any>;
      geo: {
        continent: string | null;
        country: string | null;
        region: string | null;
        postalCode: string | null;
        regionCode: string | null;
        isEUCountry: boolean | null;
        timezone: string | null;
        longitude: number | null;
        latitude: number | null;
      };
    };
    response: {
      headers: Record<string, any>;
    };
    trace?: {
      input: Record<string, unknown>;
      output?:
        | string
        | Array<Record<string, unknown>>
        | Record<string, unknown>
        | null;

      usage?: {
        promptTokens: number;
        completionTokens: number;
        totalTokens: number;
      };
      steps: Array<{
        id: string;
        title: string;
        networkGroup: "seo" | "web";
        status: "success" | "error" | "pending";
        icons: string[];
        input: Record<string, unknown>;
        output?:
          | string
          | Array<Record<string, unknown>>
          | Record<string, unknown>
          | null;
        apiData?: {
          provider: string;
          url: string;
          endpoint: string;
          method: string;
          dataSendMethod: "query" | "body";
        };
        error?: string | null;
        timestamp: string;
      }>;
      error?: string | null;
    };

};
created_at: string;
}
Obtain a list of observations from the Tedi chat completions. This endpoint allows you to retrieve observations based on various filters and parameters. Entity Reference:
ChatEntity
Example

​
Request

​
Query Parameters

​
limit
integer
The maximum number of observations to return. Default is 10, maximum is 100.Example: https://api.evergreens.ai/v1/observations?limit=10
​
page
integer
The page number to retrieve. Default is 1. Example: https://api.evergreens.ai/v1/observations?page=2

​
Response

​
id
string
The unique identifier of the observation.
​
api_key_id
string
The identifier of the API key used for the request.
​
ip
string
The IP address from which the request originated.
​
user_agent
string
The user agent string of the client making the request.
​
http_status
integer
The HTTP status code returned for the request.
​
method
string
The HTTP method used for the request (e.g., GET, POST).
​
path
string
The endpoint path that was accessed.
​
status
enum
The status of the observation, either “success” or “error”.
​
metadata
object
Additional metadata about the request and response.
​
created_at
string
The timestamp when the observation was created.
{
  id: string;
  api_key_id: string;
  ip: string;
  user_agent: string;
  http_status: number;
  method: string;
  path: string;
  status: "success" | "error";
  metadata?: {
    request: {
      headers: Record<string, any>;
      geo: {
        continent: string | null;
        country: string | null;
        region: string | null;
        postalCode: string | null;
        regionCode: string | null;
        isEUCountry: boolean | null;
        timezone: string | null;
        longitude: number | null;
        latitude: number | null;
      };
    };
    response: {
      headers: Record<string, any>;
    };
    trace?: {
      input: Record<string, unknown>;
      output?:
        | string
        | Array<Record<string, unknown>>
        | Record<string, unknown>
        | null;

      usage?: {
        promptTokens: number;
        completionTokens: number;
        totalTokens: number;
      };
      steps: Array<{
        id: string;
        title: string;
        networkGroup: "seo" | "web";
        status: "success" | "error" | "pending";
        icons: string[];
        input: Record<string, unknown>;
        output?:
          | string
          | Array<Record<string, unknown>>
          | Record<string, unknown>
          | null;
        apiData?: {
          provider: string;
          url: string;
          endpoint: string;
          method: string;
          dataSendMethod: "query" | "body";
        };
        error?: string | null;
        timestamp: string;
      }>;
      error?: string | null;
    };

};
created_at: string;
}