cURL
curl https://api.neuraldraft.io/v1/projects/me/usage \
-H "Authorization: Bearer ndsk_live_yourkey"const usage = await nd.projects.usage();
console.log(`${usage.credits_remaining} credits left`);
usage = requests.get(
"https://api.neuraldraft.io/v1/projects/me/usage",
headers={"Authorization": f"Bearer {key}"},
).json()
<?php
$usage = json_decode((string) $client->get('projects/me/usage', [
'headers' => ['Authorization' => 'Bearer '.$key],
])->getBody(), true);
{
"period_start": "2026-04-01T00:00:00Z",
"period_end": "2026-05-01T00:00:00Z",
"plan": "hobby",
"plan_credits": 5000,
"topup_credits": 2000,
"credits_used": 1295,
"credits_remaining": 5705,
"breakdown": [
{
"op": "blog_post",
"count": 8,
"credits": 480
},
{
"op": "social_post",
"count": 32,
"credits": 160
},
{
"op": "image",
"count": 15,
"credits": 480
},
{
"op": "translate_language",
"count": 12,
"credits": 84
},
{
"op": "chat_message",
"count": 91,
"credits": 91
}
]
}{
"type": "https://api.neuraldraft.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"detail": "API key missing or invalid.",
"code": "unauthorized",
"instance": "req_2Nh4PqRsTuVw"
}Projects
Get credit usage for the current period
Returns current credit balance, period boundaries, and a breakdown of credits consumed by operation type since the period started.
The period resets monthly on the same calendar day the project was created. Top-up credits do not expire and are consumed only after the plan allowance for the period is exhausted.
GET
/
projects
/
me
/
usage
cURL
curl https://api.neuraldraft.io/v1/projects/me/usage \
-H "Authorization: Bearer ndsk_live_yourkey"const usage = await nd.projects.usage();
console.log(`${usage.credits_remaining} credits left`);
usage = requests.get(
"https://api.neuraldraft.io/v1/projects/me/usage",
headers={"Authorization": f"Bearer {key}"},
).json()
<?php
$usage = json_decode((string) $client->get('projects/me/usage', [
'headers' => ['Authorization' => 'Bearer '.$key],
])->getBody(), true);
{
"period_start": "2026-04-01T00:00:00Z",
"period_end": "2026-05-01T00:00:00Z",
"plan": "hobby",
"plan_credits": 5000,
"topup_credits": 2000,
"credits_used": 1295,
"credits_remaining": 5705,
"breakdown": [
{
"op": "blog_post",
"count": 8,
"credits": 480
},
{
"op": "social_post",
"count": 32,
"credits": 160
},
{
"op": "image",
"count": 15,
"credits": 480
},
{
"op": "translate_language",
"count": 12,
"credits": 84
},
{
"op": "chat_message",
"count": 91,
"credits": 91
}
]
}{
"type": "https://api.neuraldraft.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"detail": "API key missing or invalid.",
"code": "unauthorized",
"instance": "req_2Nh4PqRsTuVw"
}Authorizations
Project API key. Pass as Authorization: Bearer ndsk_live_.... Manage
keys via /projects/me/api-keys. Test-mode keys use
the ndsk_test_ prefix.
Query Parameters
Which billing period to return.
Available options:
current, previous Response
Usage object.
Available options:
free, hobby, build, scale, enterprise Example:
5000
Example:
3260
Example:
3740
Show child attributes
Show child attributes
Example:
2000