---
title: "Submit Prepayment Balances"
method: POST
path: "/v1/installations/{integrationConfigurationId}/billing/balance"
tags: ["marketplace"]
---

# Submit Prepayment Balances

`POST /v1/installations/{integrationConfigurationId}/billing/balance`

Sends the prepayment balances. The partner should do this at least once a day and ideally once per hour. <br/> Use the `credentials.access_token` we provided in the [Upsert Installation](#upsert-installation) body to authorize this request.

## Path parameters

- `integrationConfigurationId` string, required

## Request body

- object
  - `timestamp` string, date-time, required — Server time of your integration, used to determine the most recent data for race conditions & updates. Only the latest usage data for a given day, week, and month will be kept.
  - `balances` object[], required
    - `resourceId` string — Partner's resource ID, exclude if credits are tied to the installation and not an individual resource.
    - `credit` string — A human-readable description of the credits the user currently has, e.g. "2,000 Tokens"
    - `nameLabel` string — The name of the credits, for display purposes, e.g. "Tokens"
    - `currencyValueInCents` number, required — The dollar value of the credit balance, in USD and provided in cents, which is used to trigger automatic purchase thresholds.

## Response `201`

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)