Créditos consumidos

GEThttps://pricto.dev/v1/usage

Credits consumed, grouped by day, operation, channel or key

Créditos	MCP
0	—

Parámetros#

Parámetro	En	Tipo	Descripción
`from`	query	`string (date)`	Start date, inclusive. Defaults to 90 days before `to`.
`to`	query	`string (date)`	End date, inclusive. Defaults to today.
`group_by`	query	`string`	Valores / values: `day`, `operation`, `channel`, `key`. Default: `day`.

Respuesta#

200 Usage rows.

Campo	Tipo	Descripción
`data` requerido	`UsageRow[]`
`data[].key` requerido	`string`	Group value (a date, an operation, a channel or a key ID).
`data[].credits` requerido	`number`
`data[].requests` requerido	`integer`
`meta` requerido	`Meta`

meta trae el costo, la fuente para citar, el idioma, la moneda y los avisos (ver Convenciones).

Errores#

unauthorized

Credits consumed, grouped by day, operation, channel or key

GEThttps://pricto.dev/v1/usage

Credits consumed, grouped by day, operation, channel or key

Credits	MCP
0	—

Parameters#

Parameter	In	Type	Description
`from`	query	`string (date)`	Start date, inclusive. Defaults to 90 days before `to`.
`to`	query	`string (date)`	End date, inclusive. Defaults to today.
`group_by`	query	`string`	Valores / values: `day`, `operation`, `channel`, `key`. Default: `day`.

Response#

200 Usage rows.

Field	Type	Description
`data` required	`UsageRow[]`
`data[].key` required	`string`	Group value (a date, an operation, a channel or a key ID).
`data[].credits` required	`number`
`data[].requests` required	`integer`
`meta` required	`Meta`

meta carries the cost, the source line to quote, the language, the currency and notices (see Conventions).

Errors#

unauthorized

Ejemplo#

curl "https://pricto.dev/v1/usage?group_by=operation" \
  -H "Authorization: Bearer sk_test_sandbox"

import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/usage",
    params={"group_by": "operation"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())

const API_KEY = "sk_test_sandbox";

const res = await fetch(`https://pricto.dev/v1/usage?${new URLSearchParams({"group_by":"operation"})}`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(res.status, await res.json());

200 · respuesta real de la sandbox

{
  "data": [
    {
      "key": "search",
      "credits": 2,
      "requests": 2
    },
    {
      "key": "resolve",
      "credits": 1,
      "requests": 1
    },
    "… 3 más / more"
  ],
  "meta": {
    "request_id": "req_d720ba503b1c4121b0e0",
    "credits_charged": 0,
    "credits_deduplicated": 0,
    "credits_remaining": 14988,
    "period_resets_at": "2026-11-01T00:00:00.000Z",
    "usage": {
      "credits_charged": 0,
      "credits_deduplicated": 0,
      "truncated": false,
      "truncated_reason": null,
      "dry_run": false,
      "units": {}
    },
    "lang": "es",
    "currency": "local",
    "data_as_of": "2026-10-23T11:00:00Z",
    "warnings": [
      "synthetic_data: datos sintéticos de ejemplo / synthetic sample data"
    ]
  }
}

Example#

curl "https://pricto.dev/v1/usage?group_by=operation" \
  -H "Authorization: Bearer sk_test_sandbox"

import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/usage",
    params={"group_by": "operation"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())

const API_KEY = "sk_test_sandbox";

const res = await fetch(`https://pricto.dev/v1/usage?${new URLSearchParams({"group_by":"operation"})}`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(res.status, await res.json());

200 · real sandbox response

{
  "data": [
    {
      "key": "search",
      "credits": 2,
      "requests": 2
    },
    {
      "key": "resolve",
      "credits": 1,
      "requests": 1
    },
    "… 3 más / more"
  ],
  "meta": {
    "request_id": "req_d720ba503b1c4121b0e0",
    "credits_charged": 0,
    "credits_deduplicated": 0,
    "credits_remaining": 14988,
    "period_resets_at": "2026-11-01T00:00:00.000Z",
    "usage": {
      "credits_charged": 0,
      "credits_deduplicated": 0,
      "truncated": false,
      "truncated_reason": null,
      "dry_run": false,
      "units": {}
    },
    "lang": "es",
    "currency": "local",
    "data_as_of": "2026-10-23T11:00:00Z",
    "warnings": [
      "synthetic_data: datos sintéticos de ejemplo / synthetic sample data"
    ]
  }
}