`GET /v1/usage`

Read the selected owned resource or current workflow state without starting a new generation.

Request example#

curl 'https://platform.tongai.io/v1/usage' \  -H "Authorization: Bearer $TONG_API_KEY"

Configuration

curl --version

Use a server-side API key for your account, or OAuth for each customer’s account. Never send keys in prompts or tool arguments.

usage:read

fromstringOptional

ISO 8601 date and time, for example 2026-10-22T09:00:00Z.

tostringOptional

ISO 8601 date and time, for example 2026-10-22T09:00:00Z.

channelstringOptional

Allowed values"api""mcp"

credential_idstringOptional

A 24-character hexadecimal ID.

toolstringOptional

Minimum length: 1 characters.

Maximum length: 100 characters.

modelstringOptional

Choose a public Tong model ID from current discovery.

Minimum length: 1 characters.

Maximum length: 150 characters.

categorystringOptional

Minimum length: 1 characters.

Maximum length: 60 characters.

statestringOptional

Allowed values"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

searchstringOptional

Maximum length: 150 characters.

activitystringOptional

Allowed values"creative""all"

outcomestringOptional

Allowed values"success""error""pending""cancelled"

limitintegerOptional

Minimum: 1.

Maximum: 100.

Default: 40.

This endpoint has no request body.

Response

JSON

{}

application/json

object

HTTP	Error	Recovery
`400`	Invalid request`REQUEST_INVALID`	Correct the fields identified by the error before trying again.
`401`	Invalid credential`CREDENTIAL_INVALID`	Check the credential, its expiry and whether it has been revoked.
`402`	Insufficient credits`INSUFFICIENT_CREDITS`	Add credits to the account that owns the credential, then continue the saved work.
`403`	Permission denied`SCOPE_REQUIRED`	Use a credential with the required scopes and access to the selected resource.
`404`	Resource unavailable`RESOURCE_UNAVAILABLE`	Check the resource ID and that it belongs to the authorized account.
`409`	Intent conflict`IDEMPOTENCY_CONFLICT`	Reuse an intent only with its original request. Use a new UUID for a different action.
`429`	Rate limited`RATE_LIMITED`	Wait for Retry-After before retrying the same intended request.
`503`	Temporarily unavailable`DEPENDENCY_UNAVAILABLE`	Wait for Retry-After and retry with the same intent. Check the saved operation after a timeout.