The Billing Profiles API from Google Campaign Manager — 2 operation(s) for billing profiles.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/google-campaign-manager:google-campaign-manager-billing-profiles-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Campaign Manager 360 Billing Profiles API
version: v5
description: Generated from Google's published Discovery document for Campaign Manager 360 API (dfareporting v5, revision 20261107). 3 operation(s).
contact:
name: Google
url: https://developers.google.com/
termsOfService: https://developers.google.com/terms
servers:
- url: https://dfareporting.googleapis.com
tags:
- name: Billing Profiles
paths:
/dfareporting/v5/userprofiles/{userprofilesId}/billingProfiles:
put:
operationId: dfareporting.billingProfiles.update
summary: Update billingProfiles
description: Updates an existing billing profile.
parameters:
- name: userprofilesId
in: path
required: true
description: Resource name segment (userprofilesId).
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfile'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfile'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/dfatrafficking
- apiKey: []
tags:
- Billing Profiles
get:
operationId: dfareporting.billingProfiles.list
summary: List billingProfiles
description: Retrieves a list of billing profiles, possibly filtered. This method supports paging.
parameters:
- name: userprofilesId
in: path
required: true
description: Resource name segment (userprofilesId).
schema:
type: string
- name: currency_code
in: query
required: false
description: Select only billing profile with currency.
schema:
type: string
- name: ids
in: query
required: false
description: Select only billing profile with these IDs.
schema:
type: array
items:
format: int64
type: string
- name: maxResults
in: query
required: false
description: Maximum number of results to return.
schema:
default: '1000'
format: int32
type: integer
- name: name
in: query
required: false
description: Allows searching for billing profiles by name. Wildcards (*) are allowed. For example, "profile*2020" will return objects with names like "profile June 2020", "profile April 2020", or simply "profile 2020". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "profile" will match objects with name "my profile", "profile 2021", or simply "profile".
schema:
type: string
- name: onlySuggestion
in: query
required: false
description: Select only billing profile which is suggested for the currency_code & subaccount_id using the Billing Suggestion API.
schema:
type: boolean
- name: pageToken
in: query
required: false
description: Value of the nextPageToken from the previous result page.
schema:
type: string
- name: sortField
in: query
required: false
description: Field by which to sort the list.
schema:
default: ID
type: string
enum:
- ID
- NAME
- name: sortOrder
in: query
required: false
description: Order of sorted results.
schema:
type: string
default: ASCENDING
enum:
- ASCENDING
- DESCENDING
- name: status
in: query
required: false
description: Select only billing profile with the specified status.
schema:
type: array
items:
type: string
enum:
- UNDER_REVIEW
- ACTIVE
- ARCHIVED
- name: subaccountIds
in: query
required: false
description: Select only billing profile with the specified subaccount.When only_suggestion is true, only a single subaccount_id is supported.
schema:
type: array
items:
format: int64
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfilesListResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/dfatrafficking
- apiKey: []
tags:
- Billing Profiles
/dfareporting/v5/userprofiles/{userprofilesId}/billingProfiles/{billingProfilesId}:
get:
operationId: dfareporting.billingProfiles.get
summary: Get billingProfiles
description: Gets one billing profile by ID.
parameters:
- name: userprofilesId
in: path
required: true
description: Resource name segment (userprofilesId).
schema:
type: string
- name: billingProfilesId
in: path
required: true
description: Resource name segment (billingProfilesId).
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/BillingProfile'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/dfatrafficking
- apiKey: []
tags:
- Billing Profiles
components:
schemas:
GoogleRpcError:
type: object
description: The error envelope every Google API returns.
properties:
error:
type: object
properties:
code:
type: integer
message:
type: string
status:
type: string
details:
type: array
items:
type: object
BillingProfile:
type: object
properties:
invoiceLevel:
description: Invoice level for this billing profile. Used to group fees into separate invoices by account, advertiser, or campaign.
enum:
- ACCOUNT_LEVEL
- ADVERTISER_LEVEL
- CAMPAIGN_LEVEL
type: string
purchaseOrder:
type: string
description: Purchase order (PO) for this billing profile. This PO number is used in the invoices for all of the advertisers in this billing profile.
kind:
type: string
description: 'Identifies what kind of resource this is. Value: the fixed string "dfareporting#billingProfile".'
paymentsCustomerId:
type: string
description: The ID of the payment customer the billing profile belongs to. This is a read-only field.
countryCode:
description: Country code of this billing profile.This is a read-only field.
type: string
id:
description: ID of this billing profile. This is a read-only, auto-generated field.
type: string
format: int64
isDefault:
type: boolean
description: True if the billing profile is the account default profile. This is a read-only field.
secondaryPaymentsCustomerId:
type: string
description: The ID of the secondary payment customer the billing profile belongs to. This is a read-only field.
status:
description: Status of this billing profile.This is a read-only field.
type: string
enum:
- UNDER_REVIEW
- ACTIVE
- ARCHIVED
name:
type: string
description: Name of this billing profile. This is a required field and must be less than 256 characters long and must be unique among billing profile in the same account.
consolidatedInvoice:
type: boolean
description: Consolidated invoice option for this billing profile. Used to get a single, consolidated invoice across the chosen invoice level.
currencyCode:
type: string
description: Billing currency code in ISO 4217 format.This is a read-only field.
paymentsAccountId:
description: The ID of the payment account the billing profile belongs to. This is a read-only field.
type: string
description: Contains properties of a Campaign Manager Billing Profile.
BillingProfilesListResponse:
properties:
kind:
description: 'Identifies what kind of resource this is. Value: the fixed string "dfareporting#billingProfilesListResponse".'
type: string
nextPageToken:
type: string
description: Pagination token to be used for the next list operation.
billingProfiles:
description: Billing profiles collection.
type: array
items:
$ref: '#/components/schemas/BillingProfile'
description: Billing profile List Response
type: object
securitySchemes:
apiKey:
type: apiKey
in: query
name: key
description: API key; accepted by methods that do not need user data.
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://accounts.google.com/o/oauth2/auth
tokenUrl: https://oauth2.googleapis.com/token
scopes:
https://www.googleapis.com/auth/ddmconversions: Manage DoubleClick Digital Marketing conversions
https://www.googleapis.com/auth/dfatrafficking: View and manage your DoubleClick Campaign Manager's (DCM) display ad campaigns
https://www.googleapis.com/auth/dfareporting: View and manage DoubleClick for Advertisers reports
externalDocs:
url: https://developers.google.com/doubleclick-advertisers/
x-provenance:
method: harvested
publisher: Google
source: https://dfareporting.googleapis.com/$discovery/rest?version=v5
note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261107)