> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Account-spend-limit get

> Read the Meta ad account's spending limit and how much has been spent toward it. When the limit is reached Meta stops delivery for EVERY campaign in the account at once. Amounts are in the account currency's standard units. This counter is not calendar-month spend.

CLI: `adside meta account-spend-limit get`



## OpenAPI

````yaml /api-reference/openapi.yaml post /v1/workspaces/{workspaceId}/meta/account-spend-limit/get
openapi: 3.1.0
info:
  title: Adside API
  version: 1.0.0
  description: >-
    Campaigns, creatives, assets and reporting across your ad accounts. Call it
    with a personal API key as a bearer token, or with the `adside` CLI: each
    page names its command.
servers:
  - url: https://api.adside.ai
    description: Production
security:
  - userAccess: []
tags:
  - name: Account
  - name: Reporting
  - name: Meta
  - name: Google Ads
  - name: LinkedIn
  - name: TikTok
  - name: Reddit
  - name: Snapchat
  - name: X
  - name: Google Tag Manager
  - name: Creatives
  - name: Creative styles
  - name: Media
  - name: Characters
  - name: Assets
  - name: Brands
  - name: Brain
  - name: Research
  - name: Boards
  - name: Artifacts
  - name: Audiences
  - name: Ad comments
  - name: Publications
  - name: Routines
  - name: Skills
  - name: To-dos
  - name: Audit
  - name: Credits
paths:
  /v1/workspaces/{workspaceId}/meta/account-spend-limit/get:
    post:
      tags:
        - Meta
      summary: Account-spend-limit get
      description: >-
        Read the Meta ad account's spending limit and how much has been spent
        toward it. When the limit is reached Meta stops delivery for EVERY
        campaign in the account at once. Amounts are in the account currency's
        standard units. This counter is not calendar-month spend.


        CLI: `adside meta account-spend-limit get`
      operationId: meta.get_meta_account_spend_limit
      parameters:
        - name: workspaceId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                account_id:
                  description: Meta Ad Account ID (uses configured account if not provided)
                  type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  account_id:
                    type: string
                  account_name:
                    type: string
                  currency:
                    type: string
                  has_spend_limit:
                    type: boolean
                  spend_limit:
                    anyOf:
                      - type: number
                        minimum: 0
                      - type: 'null'
                  amount_spent:
                    type: number
                    minimum: 0
                  remaining:
                    anyOf:
                      - type: number
                        minimum: 0
                      - type: 'null'
                  limit_reached:
                    type: boolean
                  delivery:
                    type: string
                    enum:
                      - stopped_by_spend_limit
                      - under_limit
                      - no_limit
                  note:
                    type: string
                  checked_at:
                    type: string
                    format: date-time
                    pattern: >-
                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                required:
                  - account_id
                  - account_name
                  - currency
                  - has_spend_limit
                  - spend_limit
                  - amount_spent
                  - remaining
                  - limit_reached
                  - delivery
                  - note
                  - checked_at
                additionalProperties: false
      security:
        - userAccess: []
components:
  securitySchemes:
    userAccess:
      type: http
      scheme: bearer
      description: >-
        A personal API key (`adside_pat_…`) or a token from `adside login`.
        Either carries the permissions of the person it belongs to.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.