---
title: "Sync closed billing ledger overage to Stripe"
method: POST
path: "/admin/billing/stripe/sync-overage"
tags: ["Billing"]
---

# Sync closed billing ledger overage to Stripe

`POST /admin/billing/stripe/sync-overage`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/admin/billing/stripe/sync-overage`
- Auth: API key in header `x-api-key`

Admin-only endpoint that scans closed billing period ledgers with overage credits and sends one Stripe Billing Meter Event per eligible ledger. Only overage credits are synced; included credits remain covered by the subscription price.

## Query parameters

- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

Stripe overage sync summary

- BillingStripeOverageSyncSummaryResponseDoc
  - `code` integer
  - `data` BillingStripeOverageSyncSummaryDoc
    - `ambiguous` integer
    - `errors` BillingStripeOverageSyncErrorDoc[]
      - `error` string
      - `period_key` string
      - `user_id` string
    - `failed` integer
    - `not_required` integer
    - `scanned` integer
    - `skipped` integer
    - `synced` integer
  - `msg` string

## Other responses

- `401`: Authentication required
- `403`: Admin plan required
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)