List cost-records

GET

/cost-records

• Current canonical versioned path (F3.API.01)

Per-tenant COGS evidence dle FOCUS v1.3 schema (F2.AISTACK.02). Zahrnuje EffectiveCost, ListCost, ServiceName, ResourceId a kategorii nákladů (ai_inference/compute/storage/…). Plněno batch ingestem z cloud-connectoru přes /api/cost-records/ingest-focus.

Authorizations

• bearerAuth
• apiTokenAuth

Parameters

Query Parameters

pagination[page]

integer

pagination[pageSize]

integer

filters

Strapi REST filter syntax

object

sort

string

populate

string

Responses

200

OK

object

data

Array

object

provider

required

string

Allowed values: aws azure gcp hetzner digitalocean custom

service_name

FOCUS ServiceName — čitelný název cloudové služby (napr. EC2, RDS, AKS, Cloud Run).

string

resource_id

FOCUS ResourceId — jednoznačný identifikátor zdroje u providera.

string

resource_type

FOCUS ResourceType — typ zdroje (napr. AWS::EC2::Instance, Microsoft.Compute/virtualMachines).

string

billed_cost

FOCUS EffectiveCost — výsledná cena po uplatnění slev, commitmentů a SP.

number

list_cost

FOCUS ListCost — sazebníková cena před jakýmikoliv slevami.

number

currency

ISO 4217 kód měny (EUR, USD, CZK, GBP, …).

string

billing_period_start

FOCUS BillingPeriodStart — začátek fakturačního období (UTC).

string format: date-time

billing_period_end

FOCUS BillingPeriodEnd — konec fakturačního období (UTC).

string format: date-time

region

Cloud region/zóna kde byl resource provozován.

string

account_id

Cloud account/subscription/project ID — FOCUS BillingAccountId.

string

tags

Resource tagy v původní podobě z providera (key-value mapa).

focus_schema_version

Verze FOCUS schématu, podle které byl záznam vygenerován.

string

category

Sencai kategorie nákladů — vstup pro COGS breakdown a margin kalkulaci.

string

Allowed values: ai_inference compute storage network database monitoring other

source

Zdroj dat: aws_cur (Cost & Usage Report), azure_cost_export, gcp_billing_export, manual.

string

Allowed values: aws_cur azure_cost_export gcp_billing_export manual

ingested_at

Timestamp kdy byl záznam ingested do Sencai (UTC).

string format: date-time

organisation

One of:

string

DocumentId reference to api::organisation.organisation

string

object

object

key

additional properties

any

home_region

required

Logical data-residency region of the tenant (CELL invariant, F2.CELL.01)

string

Allowed values: eu us apac

cell_id

Deployment cell within home_region for blast-radius isolation (CELL invariant, F2.CELL.01)

string

documentId

string

id

integer

createdAt

string format: date-time

updatedAt

string format: date-time

publishedAt

string format: date-time

nullable

meta

object

pagination

object

page

integer

pageSize

integer

pageCount

integer

total

integer

401

Missing or invalid authentication

403

Not authorized (tenant scope or capability)