GETAccountFree

Get credit balance

GET https://api.instagramapi.dev/v1/credits

Returns the number of credits remaining on your account. This call is free. It never consumes a credit and does not query Instagram. Use it to monitor usage or surface a live balance in your own dashboard.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

This endpoint takes no parameters, just your API key.

Example request

curl "https://api.instagramapi.dev/v1/credits" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/credits", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/credits",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

Try it

Live request · uses 0 credits

API key

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "credits_remaining": 4987
  },
  "meta": {
    "endpoint": "credits",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 0,
    "credits_remaining": 4987
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

Field	Type	Description
credits_remaining	number	Number of credits left on your account.