Passer au contenu principal
GET
/
marketing
/
v3
/
campaigns
/
{campaignGuid}
/
budget
/
totals
Lire le budget
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/campaigns/{campaignGuid}/budget/totals \
  --header 'Authorization: Bearer <token>'
{
  "budgetItems": [
    {
      "amount": 123,
      "createdAt": 123,
      "id": "<string>",
      "name": "<string>",
      "order": 123,
      "updatedAt": 123,
      "description": "<string>"
    }
  ],
  "currencyCode": "AED",
  "spendItems": [
    {
      "amount": 123,
      "createdAt": 123,
      "id": "<string>",
      "name": "<string>",
      "order": 123,
      "updatedAt": 123,
      "description": "<string>"
    }
  ],
  "budgetTotal": 123,
  "remainingBudget": 123,
  "spendTotal": 123
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Pro
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Paramètres de chemin

campaignGuid
string
requis

Identifiant unique pour la campagne, formaté en tant que GUID.

Réponse

successful operation

budgetItems
object[]
requis
currencyCode
enum<string>
requis

Le code de devise utilisé pour le budget et les montants dépensés, conformément à la norme ISO 4217.

Options disponibles:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BOV,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHE,
CHF,
CHW,
CLF,
CLP,
CNY,
COP,
COU,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MXV,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
USN,
UYI,
UYU,
UZS,
VEF,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XBA,
XBB,
XBC,
XBD,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
XSU,
XUA,
YER,
ZAR,
ZMW,
ZWL
spendItems
object[]
requis
budgetTotal
number

Le budget total attribué à la campagne.

remainingBudget
number

Budget restant disponible pour la campagne après prise en compte de tous les postes de dépenses.

spendTotal
number

Montant total dépensé pour tous les postes de dépenses de la campagne.

Last modified on January 26, 2026