Get My Spend

GET

/metering-service/api/v2/organizations/{organization_id}/spend/me

Describes the caller's own spend for a billing period: their spend against their limit, tokens, their daily trend, and their spend per assistant.
Every spend value in this API is a decimal string rather than a number, to avoid precision loss.
Any organization member can call this endpoint.

Path Parameters

organization_id: The Ejento AI organization ID.

Query Parameters

billing_period: Defines the billing period in YYYY-MM format. Defaults to the current month.

Returns

JSON Response: the caller's own spend detail for the period in a success envelope.

Current Version

2.0.0

Request

Path Params

Query Params

Header Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠400

🟠401

🟠403

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https:///metering-service/api/v2/organizations//spend/me?billing_period=undefined' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "billing_period": "string",
        "spend": "string",
        "limit_amount": "string",
        "approved_increase_amount": "string",
        "pct_used": 0,
        "total_tokens": 0,
        "sessions": 0,
        "status": "ACTIVE",
        "blocked_reason": "USER_LIMIT",
        "resets_at": "2019-08-24T14:15:22.123Z",
        "has_open_increase_request": true,
        "daily": [
            {
                "day": "2019-08-24",
                "spend": "string",
                "total_tokens": 0
            }
        ],
        "by_agent": [
            {
                "agent_id": 0,
                "agent_name": "string",
                "spend": "string",
                "total_tokens": 0
            }
        ]
    }
}

Get Spend User Detail