List credit grants

GET

https://api.schematichq.com/billing/credits/grants/list

GET

/billing/credits/grants/list

1 import { SchematicClient } from "@schematichq/schematic-typescript-node";
2 
3 async function main() {
4     const client = new SchematicClient({
5         apiKey: "YOUR_API_KEY_HERE",
6     });
7     await client.credits.listGrantsForCredit({});
8 }
9 main();

1 {
2   "data": [
3     {
4       "company_id": "c1234567890",
5       "company_name": "Acme Corporation",
6       "created_at": "2024-01-15T09:30:00Z",
7       "credit_id": "crd_987654321",
8       "credit_name": "Monthly Usage Credit",
9       "grant_reason": "plan",
10       "id": "grant_123abc456def",
11       "quantity": 1000,
12       "quantity_remaining": 750.5,
13       "quantity_used": 249.5,
14       "renewal_enabled": true,
15       "source_label": "Subscription Renewal",
16       "updated_at": "2024-02-15T10:00:00Z",
17       "credit_icon": "https://cdn.schematichq.com/icons/credit-default.png",
18       "currency": "USD",
19       "expires_at": "2024-12-31T23:59:59Z",
20       "plan_id": "plan_premium_001",
21       "plan_name": "Premium Plan",
22       "price": {
23         "currency": "USD",
24         "external_price_id": "price_1Hh1YZ2eZvKYlo2C0qX9bX9L",
25         "id": "price_001",
26         "interval": "month",
27         "price": 4999,
28         "provider_type": "stripe",
29         "scheme": "per_unit",
30         "price_decimal": "49.99"
31       },
32       "renewal_period": "monthly",
33       "transfers": [
34         {
35           "amount": 250,
36           "created_at": "2024-02-01T00:00:00Z",
37           "direction": "inbound",
38           "id": "transfer_789xyz123abc",
39           "reason": "top-up",
40           "related_grant_id": "grant_123abc456def"
41         }
42       ],
43       "valid_from": "2024-01-01T00:00:00Z",
44       "zeroed_out_date": "2024-01-31T23:59:59Z",
45       "zeroed_out_reason": "expired"
46     }
47   ],
48   "params": {
49     "credit_id": "crd_987654321",
50     "ids": [
51       "grant_123abc456def"
52     ],
53     "limit": 100,
54     "offset": 0
55   }
56 }

Authentication

X-Schematic-Api-Keystring

API Key authentication via header

Query parameters

credit_idstringOptional

idslist of stringsOptional

limitlongOptional

Page limit (default 100)

offsetlongOptional

Page offset (default 0)

Response

datalist of objects

paramsobject

Input parameters

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error