Usage and requests | Lahjty API

Read the shared credit balance, reconcile recent usage, and recover stored results after a client timeout.

GET/usage

Read balance and recent usage

Returns the shared Lahjty balance and recent API charges for reconciliation and reporting.

curl --request GET \
  --url https://www.lahjty.com/api/v1/usage \
  --header "Authorization: Bearer $LAHJTY_API_KEY"

Example response

response.json

{
  "balance": 476,
  "credits_used": 24,
  "requests": [
    {
      "id": "req_01jexample",
      "operation": "campaign",
      "status": "completed",
      "credits": 12,
      "credits_refunded": 0
    }
  ]
}

GET/requests/req_01jexample

Recover a request after timeout

Terminal request records and generated payloads are retained for 30 days. Use the previously returned request_id.

curl --request GET \
  --url https://www.lahjty.com/api/v1/requests/req_01jexample \
  --header "Authorization: Bearer $LAHJTY_API_KEY"

Example response

response.json

{
  "id": "req_01jexample",
  "object": "api_request",
  "status": "completed",
  "operation": "copy",
  "credits": 2,
  "credits_charged": 2,
  "credits_refunded": 0,
  "result": {
    "id": "cpy_01jexample",
    "object": "copy_generation",
    "status": "completed"
  }
}

Reconciliation fields

Persist request_id from every success and problem response.
Use external_id for your campaign and external_customer_id for the merchant.
Treat the usage response and outcome refund status as the financial record, not a client-side estimate.