{
  "url": "https://telipot.com/catalog/tasks/apollo.account.usage",
  "id": "apollo.account.usage",
  "name": "Credits used and left this billing cycle by credit type",
  "provider": {
    "slug": "apollo",
    "name": "Apollo"
  },
  "capability": "account.usage",
  "platform": "account",
  "kind": "account",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "amount": "Free",
    "state": "free",
    "label": "Free",
    "detail": "Free from the tool",
    "type": "free"
  },
  "providers": 3,
  "retention": "standard",
  "runsOn": "free",
  "live": true,
  "summary": "Use the view credit usage stats endpoint to monitor your team's credit balance across every credit type in the current billing cycle.",
  "method": "POST",
  "path": "/usage_stats/credit_usage_stats",
  "host": "https://api.apollo.io/api/v1",
  "docsUrl": "https://docs.apollo.io/reference/view-credit-usage-stats",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in header as x-api-key",
    "short": "api_key · x-api-key"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "none",
    "label": "Not verified yet",
    "detail": "Not checked yet. We test with a real request before we mark it."
  },
  "input": [],
  "sampleInput": {},
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "output": [
    {
      "name": "credit_usage_stats",
      "type": "object",
      "description": "Per credit type: limit, consumed and left_over. Credits, except dialer, which is minutes."
    },
    {
      "name": "current_credit_cycle",
      "type": "object",
      "description": "Start and end of the billing cycle; both null when the team has no active cycle."
    }
  ],
  "outputSchema": {
    "type": "object",
    "required": [
      "credit_usage_stats"
    ],
    "properties": {
      "credit_usage_stats": {
        "type": "object",
        "description": "Per credit type: limit, consumed and left_over. Credits, except dialer, which is minutes.",
        "required": [
          "lead_credit",
          "direct_dial_credit",
          "export_credit",
          "conversation_credit",
          "ai_credit",
          "power_up_credit",
          "inbound_website_visitor_credit",
          "contact_website_visitor_credit",
          "web_search_record_credit",
          "dialer"
        ],
        "properties": {
          "lead_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "direct_dial_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "export_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "conversation_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "ai_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "power_up_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "inbound_website_visitor_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "contact_website_visitor_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "web_search_record_credit": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          },
          "dialer": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer"
              },
              "consumed": {
                "type": "integer"
              },
              "left_over": {
                "type": "integer"
              }
            }
          }
        }
      },
      "current_credit_cycle": {
        "type": "object",
        "description": "Start and end of the billing cycle; both null when the team has no active cycle.",
        "properties": {
          "start_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "end_date": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run apollo.account.usage \\\n  --input-json '{}'",
    "http": "curl https://api.telipot.com/v1/tasks/apollo.account.usage/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{}'",
    "quote": "telipot run apollo.account.usage \\\n  --input-json '{}' \\\n  --quote"
  },
  "siblings": [
    {
      "id": "hunter.account.usage",
      "name": "Plan, credits used and credits left on the key's account",
      "provider": {
        "slug": "hunter",
        "name": "Hunter"
      },
      "capability": "account.usage",
      "platform": "account",
      "kind": "account",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "amount": "Free",
        "state": "free",
        "label": "Free",
        "detail": "Free from the tool",
        "type": "free"
      },
      "providers": 3,
      "retention": "standard",
      "runsOn": "free",
      "live": true
    },
    {
      "id": "firecrawl.account.usage",
      "name": "Credits left and plan credits for the key's account",
      "provider": {
        "slug": "firecrawl",
        "name": "Firecrawl"
      },
      "capability": "account.usage",
      "platform": "account",
      "kind": "account",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "confidence": "unknown",
        "source": "docs",
        "sourceUrl": "https://docs.firecrawl.dev/billing",
        "checked": "2026-10-05",
        "note": "The billing page's credit table lists no charge for this route and no page says it is free.",
        "type": "per_call",
        "state": "unknown",
        "label": "Price unknown",
        "detail": "Not listed, not free"
      },
      "providers": 3,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true
    }
  ]
}
