Retrieve a credit transaction

GET

https://api.respan.ai/api/credit-transactions/:id/

Retrieve details of a specific credit transaction.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

idstringRequired

The unique identifier of the transaction to retrieve (e.g., ct_1a2b3c4d5e6f7g8h)

Response

Transaction details.

idstring

Transaction ID.

organization_subscriptioninteger

Organization subscription ID.

unique_organization_idstring

Organization UUID.

amountdouble

Transaction amount in USD. Negative for deductions.

transaction_typeenum

Transaction type.

created_atdatetime

Transaction timestamp.

expires_atdatetime or null

Expiration date for time-limited credits.

descriptionstring

Transaction description.

stripe_payment_intent_idstring

Stripe payment intent ID (for purchases).

metadataobject

Custom metadata.

Errors

401

Unauthorized Error

404

Not Found Error

1	{
2	"id": "ct_9f8e7d6c5b4a3f2e",
3	"organization_subscription": 42,
4	"unique_organization_id": "d3f9a1b2-4c6e-4f7a-9b8d-123456789abc",
5	"amount": 150.75,
6	"transaction_type": "grant",
7	"created_at": "2024-04-10T14:22:00Z",
8	"expires_at": "2024-10-10T14:22:00Z",
9	"description": "Quarterly promotional credit grant",
10	"stripe_payment_intent_id": "pi_1GqIC8Lz0qyl6XeW3X9a2b7c",
11	"metadata": {
12	"campaign": "spring_promo_2024",
13	"issued_by": "system"
14	}
15	}

$	curl https://api.respan.ai/api/credit-transactions/id/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json"