---
title: "Retrieve campaign spend details"
method: POST
path: "/v2/spend/campaign"
tags: ["Spend"]
---

# Retrieve campaign spend details

`POST /v2/spend/campaign`

This endpoint calculates remaining campaign budget for specific campaigns based on their available balance and spending limits. It allows checking how much budget is left by different time periods (daily, hourly, or total) to manage campaign spending and budget allocation.

## Request body

- V2CampaignSpendRequest
  - `campaignSpendRequest` V2CampaignSpends[]
    - `id` string, required — The unique identifier of the campaign.
    - `spendType` 'SPEND_TYPE_DAILY' | 'SPEND_TYPE_HOURLY' | 'SPEND_TYPE_TOTAL', required

## Response `200`

Your campaign spending details.

- V2CampaignSpendResponse
  - `campaignSpends` V2CampaignSpend[] — Your campaign spending details for the requested time period.
    - `id` string — Your campaign's unique ID number.
    - `spendType` 'SPEND_TYPE_DAILY' | 'SPEND_TYPE_HOURLY' | 'SPEND_TYPE_TOTAL'
    - `success` CampaignSpendSuccess
      - `amount` number, double — The spending amount in your account currency.
    - `failure` CampaignSpendFailure
      - `message` string — Details about what went wrong.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)