@adcp/client API Reference - v4.19.0
    Preparing search index...

    Interface GetAccountFinancialsSuccess

    Financial data retrieved successfully

    interface GetAccountFinancialsSuccess {
        account: AccountReference;
        currency: string;
        period: DateRange;
        timezone: string;
        spend?: { total_spend: number; media_buy_count?: number };
        credit?: {
            credit_limit: number;
            available_credit: number;
            utilization_percent?: number;
        };
        balance?: {
            available: number;
            last_top_up?: { amount: number; date: string };
        };
        payment_status?: "suspended"
        | "current"
        | "past_due";
        payment_terms?:
            | "net_15"
            | "net_30"
            | "net_45"
            | "net_60"
            | "net_90"
            | "prepay";
        invoices?: {
            invoice_id: string;
            period?: DateRange;
            amount: number;
            status: "draft"
            | "void"
            | "past_due"
            | "issued"
            | "paid";
            due_date?: string;
            paid_date?: string;
        }[];
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    account currency period timezone spend? credit? balance? payment_status? payment_terms? invoices? context? ext?

    Properties

    account: AccountReference
    currency: string

    ISO 4217 currency code for all monetary amounts in this response

    period: DateRange
    timezone: string

    IANA timezone of the seller's billing day boundaries (e.g., 'America/New_York'). All dates in this response — period, invoice periods, due dates — are calendar dates in this timezone. Buyers in a different timezone should expect spend boundaries to differ from their own calendar day.

    spend?: { total_spend: number; media_buy_count?: number }

    Spend summary for the period

    Type Declaration

    • total_spend: number

      Total spend in the period, in currency

    • Optionalmedia_buy_count?: number

      Number of active media buys in the period

    credit?: {
        credit_limit: number;
        available_credit: number;
        utilization_percent?: number;
    }

    Credit status. Present for credit-based accounts (payment_terms like net_30).

    Type Declaration

    • credit_limit: number

      Maximum outstanding balance allowed

    • available_credit: number

      Remaining credit available (credit_limit minus outstanding balance)

    • Optionalutilization_percent?: number

      Credit utilization as a percentage (0-100)

    balance?: { available: number; last_top_up?: { amount: number; date: string } }

    Prepay balance. Present for prepay accounts.

    Type Declaration

    • available: number

      Remaining prepaid balance

    • Optionallast_top_up?: { amount: number; date: string }

      Most recent balance top-up

      • amount: number

        Top-up amount

      • date: string

        Date of top-up

    payment_status?: "suspended" | "current" | "past_due"

    Overall payment status. current: all obligations met. past_due: one or more invoices overdue. suspended: account suspended due to payment issues.

    payment_terms?: "net_15" | "net_30" | "net_45" | "net_60" | "net_90" | "prepay"

    Payment terms in effect for this account

    invoices?: {
        invoice_id: string;
        period?: DateRange;
        amount: number;
        status: "draft" | "void" | "past_due" | "issued" | "paid";
        due_date?: string;
        paid_date?: string;
    }[]

    Recent invoices. Sellers may limit the number returned.

    Type Declaration

    • invoice_id: string

      Seller-assigned invoice identifier

    • Optionalperiod?: DateRange
    • amount: number

      Invoice total in currency

    • status: "draft" | "void" | "past_due" | "issued" | "paid"

      Invoice status

    • Optionaldue_date?: string

      Payment due date

    • Optionalpaid_date?: string

      Date payment was received. Present when status is 'paid'.

    context?: ContextObject
    ext?: ExtensionObject

    Settings

    Member Visibility

    On This Page

    Properties