from retab import Retab

client = Retab()

# List per-operation usage rows
primitives = client.usage.list_primitives(
    limit=20,
    order="desc",
)

# Filter by operation, project, and date range
primitives = client.usage.list_primitives(
    operation="extraction",
    project_id="proj_123",
    from_date="2024-01-01",
    to_date="2024-12-31",
    limit=50,
)

for primitive in primitives.data:
    print(primitive.primitive_execution_id, primitive.operation, primitive.credits)

import { Retab } from "@retab/node";

const client = new Retab({ apiKey: process.env.RETAB_API_KEY });

// List per-operation usage rows
const primitives = await client.usage.list_primitives({
  limit: 20,
  order: "desc",
});

// Filter by operation, project, and date range
const filtered = await client.usage.list_primitives({
  operation: "extraction",
  projectId: "proj_123",
  fromDate: "2024-01-01",
  toDate: "2024-12-31",
  limit: 50,
});

console.log(primitives.data, filtered.data);

package main

import (
	"context"
	"fmt"
	"log"

	retab "github.com/retab-dev/retab/clients/go"
)

func ptr[T any](v T) *T { return &v }

func main() {
	ctx := context.Background()

	client, err := retab.NewClient("")
	if err != nil {
		log.Fatal(err)
	}

	// List per-operation usage rows
	primitives, err := client.Usage.ListPrimitives(ctx, &retab.UsageListPrimitivesParams{
		PaginationParams: retab.PaginationParams{Limit: ptr(20), Order: ptr("desc")},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(primitives)

	// Filter by operation, project, and date range
	filtered, err := client.Usage.ListPrimitives(ctx, &retab.UsageListPrimitivesParams{
		PaginationParams: retab.PaginationParams{Limit: ptr(50)},
		Operation:        ptr("extraction"),
		ProjectID:        ptr("proj_123"),
		FromDate:         ptr("2024-01-01"),
		ToDate:           ptr("2024-12-31"),
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(filtered)
}

import com.retab.RetabClient;

public final class Example {
  public static void main(String[] args) throws Exception {
    RetabClient client = new RetabClient(System.getenv("RETAB_API_KEY"));

    var primitives = client.usage().listPrimitives();
    System.out.println(primitives);
  }
}

curl -X 'GET' \
  'https://api.retab.com/v1/usage/primitives?limit=20&order=desc' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <your-api-key>'

# Filter by operation, project, and date range
curl -X 'GET' \
  'https://api.retab.com/v1/usage/primitives?operation=extraction&project_id=proj_123&from_date=2024-01-01&to_date=2024-12-31&limit=50' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <your-api-key>'

require 'retab'

client = Retab::Client.new(api_key: ENV['RETAB_API_KEY'])

# List per-operation usage rows
primitives = client.usage.list_primitives(
  limit: 20,
  order: 'desc',
)

# Filter by operation, project, and date range
primitives = client.usage.list_primitives(
  operation: 'extraction',
  project_id: 'proj_123',
  from_date: '2024-01-01',
  to_date: '2024-12-31',
  limit: 50,
)

primitives.data.each do |row|
  puts row.primitive_execution_id
end

use retab::resources::usage::ListPrimitivesParams;
use retab::Retab;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Retab::new(std::env::var("RETAB_API_KEY")?);

    // List per-operation usage rows
    let _primitives = client
        .usage()
        .list_primitives(ListPrimitivesParams {
            limit: Some(20),
            ..Default::default()
        })
        .await?;

    // Filter by operation, project, and date range
    let _filtered = client
        .usage()
        .list_primitives(ListPrimitivesParams {
            operation: Some("extraction".into()),
            project_id: Some("proj_123".into()),
            from_date: Some("2024-01-01".into()),
            to_date: Some("2024-12-31".into()),
            limit: Some(50),
            ..Default::default()
        })
        .await?;
    Ok(())
}

<?php
require 'vendor/autoload.php';

use Retab\Client;

$client = new Client(apiKey: getenv('RETAB_API_KEY'));

// List per-operation usage rows
$result = $client->usage()->listPrimitives(limit: 20);

// Filter by operation, project, and date range
$filtered = $client->usage()->listPrimitives(
    operation: 'extraction',
    projectId: 'proj_123',
    fromDate: '2024-01-01',
    toDate: '2024-12-31',
    limit: 50,
);
print_r($result);

using Retab;
using RetabClient = Retab.Retab;

var apiKey = Environment.GetEnvironmentVariable("RETAB_API_KEY")!;
var client = new RetabClient(apiKey);

// List per-operation usage rows
var result = await client.Usage.ListPrimitivesAsync(new UsageListPrimitivesOptions { Limit = 20 });

// Filter by operation, project, and date range
var filtered = await client.Usage.ListPrimitivesAsync(new UsageListPrimitivesOptions
{
    Operation = "extraction",
    ProjectId = "proj_123",
    FromDate = "2024-01-01",
    ToDate = "2024-12-31",
    Limit = 50,
});
Console.WriteLine(result);

{
  "data": [
    {
      "primitive_execution_id": "pex_01G34H8J2K",
      "operation": "extraction",
      "workflow_id": "wf_123",
      "run_id": "run_01G34H8J2K",
      "project_id": "proj_123",
      "block_id": "blk_01G34H8J2K",
      "status": "completed",
      "resource_kind": "extraction",
      "model": "retab-large",
      "created_at": "2024-03-15T10:30:00Z",
      "completed_at": "2024-03-15T10:30:12Z",
      "duration_ms": 12000,
      "page_count": 8,
      "credits": 12.5,
      "documents": [
        {
          "file_id": "file_6dd6eb00688ad8d1",
          "filename": "invoice.pdf"
        }
      ],
      "metadata": {
        "tenant": "acme"
      }
    }
  ],
  "list_metadata": {
    "before": null,
    "after": "pex_01G34H8J2K"
  }
}