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/mparticle-data-plan-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: mParticle Data Planning Data Plan API
version: 2.0.0
contact:
email: product@mparticle.com
url: https://www.mparticle.com/contact
name: mParticle Developer Experience
description: The Data Planning API for mParticle.com
termsOfService: https://www.mparticle.com/legal/website-terms-of-service/
servers:
- url: https://api.mparticle.com/platform/v2/workspaces/{workspace_id}/plans
variables:
workspace_id:
default: '0'
description: The Id of the worskspace that contains the targetted data plans
security:
- bearerAuth: []
tags:
- name: Data Plan
description: Endpoints for managing Data Plans
paths:
/:
parameters: []
get:
description: Query all data plans
operationId: get-plans
tags:
- Data Plan
responses:
'200':
$ref: '#/components/responses/DataPlanListResponse'
'400':
description: Bad Request
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
description: Not Found
'429':
$ref: '#/components/responses/TooManyRequests'
summary: Get All Plans
post:
description: Create a data plan
operationId: create-plan
tags:
- Data Plan
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DataPlan'
examples: {}
responses:
'200':
$ref: '#/components/responses/DataPlanVersionResponse'
'400':
$ref: '#/components/responses/BadSchema'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
summary: Create Data Plan
/{plan_id}:
get:
description: 'Get a single data plan '
operationId: get-plan
tags:
- Data Plan
parameters:
- $ref: '#/components/parameters/plan_id'
responses:
'200':
$ref: '#/components/responses/DataPlanResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
summary: Get a Single Plan
delete:
description: Delete a single plan
operationId: delete-plan
tags:
- Data Plan
parameters:
- $ref: '#/components/parameters/plan_id'
responses:
'204':
description: Empty response
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/DataPlanNotFound'
'429':
$ref: '#/components/responses/TooManyRequests'
summary: Delete Data Plan
patch:
description: Update a plan
operationId: update-plan
tags:
- Data Plan
parameters:
- $ref: '#/components/parameters/plan_id'
responses:
'200':
$ref: '#/components/responses/DataPlanResponse'
'400':
$ref: '#/components/responses/BadSchema'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/DataPlanNotFound'
'429':
$ref: '#/components/responses/TooManyRequests'
requestBody:
content:
application/json:
schema:
description: ''
type: object
x-examples:
example-1:
data_plan_name: description
properties:
data_plan_name:
type: string
data_plan_description:
type: string
description: ''
summary: Update Data Plan
/validate:
post:
description: Validate an event batch against a Data Plan document
operationId: validate-plan-document
parameters: []
responses:
'200':
$ref: '#/components/responses/ValidateDataPlanResponse'
'400':
$ref: '#/components/responses/ValidateDataPlanBadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
summary: Validate Event Batch
requestBody:
content:
application/json:
schema:
type: object
properties:
document:
$ref: '#/components/schemas/VersionDocument'
batch:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_Batch'
tags:
- Data Plan
components:
schemas:
Mparticle_S2s_Events_Oas_ApplicationInformation:
properties:
application_name:
type: string
application_version:
type: string
application_build_number:
type: string
install_referrer:
type: string
package:
type: string
os:
type: string
default: Unknown
enum:
- Unknown
- IOS
- Android
- WindowsPhone
- MobileWeb
- UnityIOS
- UnityAndroid
- Desktop
- TVOS
- Roku
- OutOfBand
- Alexa
- SmartTV
- FireTV
- Xbox
apple_search_ads_attributes:
type: object
additionalProperties:
type: object
additionalProperties:
type: string
additionalProperties: false
DataPlanVersion:
type: object
properties:
version:
type: integer
version_description:
type: string
created_on:
type: string
format: date-time
created_by:
type: string
last_modified_on:
type: string
format: date-time
last_modified_by:
type: string
version_document:
$ref: '#/components/schemas/VersionDocument'
activated_environment:
$ref: '#/components/schemas/ActivatedEnvironment'
data_plan_id:
type: string
quarantine_feed_id:
type:
- number
- 'null'
readOnly: true
DataPoint:
type: object
properties:
description:
type: string
match:
$ref: '#/components/schemas/DataPointMatch'
validator:
$ref: '#/components/schemas/DataPointValidator'
required:
- match
- validator
Mparticle_S2s_Events_Oas_DataPlanContext:
properties:
plan_id:
type: string
plan_version:
type: integer
required:
- plan_id
Mparticle_S2s_Events_Oas_GeoLocation:
properties:
latitude:
type: number
longitude:
type: number
accuracy:
type: number
required:
- latitude
- longitude
additionalProperties: false
Mparticle_S2s_Events_Oas_DeviceCurrentState:
properties:
time_since_start_ms:
type: integer
battery_level:
type: number
data_connection_type:
type: string
data_connection_type_detail:
type: string
gps_state:
type: boolean
total_system_memory_usage_bytes:
type: integer
disk_space_free_bytes:
type: integer
external_disk_space_free_bytes:
type: integer
cpu:
type: string
system_memory_available_bytes:
type: number
system_memory_low:
type: boolean
system_memory_threshold_bytes:
type: number
application_memory_available_bytes:
type: number
application_memory_max_bytes:
type: number
application_memory_total_bytes:
type: number
device_orientation:
type: string
enum:
- portrait
- portrait_upside_down
- landscape
- LandscapeLeft
- LandscapeRight
- FaceUp
- FaceDown
- Square
status_bar_orientation:
type: string
enum:
- portrait
- portrait_upside_down
- landscape
- LandscapeLeft
- LandscapeRight
- FaceUp
- FaceDown
- Square
additionalProperties: false
SchemaError:
type: object
allOf:
- $ref: '#/components/schemas/Error'
properties:
match_key:
type: string
value:
type: string
schema_pointer:
type: string
event_pointer:
type: string
keyword:
type: string
error_type:
type: string
required:
- message
- match_key
- error_type
ProductAction:
type: string
title: ProductAction
enum:
- add_to_cart
- remove_from_cart
- checkout
- checkout_option
- click
- view_detail
- purchase
- refund
- add_to_wishlist
- remove_from_wish_list
Mparticle_S2s_Events_Oas_GDPRConsentState:
properties:
regulation:
type: string
document:
type: string
consented:
type: boolean
timestamp_unixtime_ms:
type: integer
location:
type: string
hardware_id:
type: string
required:
- regulation
- document
- consented
- timestamp_unixtime_ms
- location
- hardware_id
additionalProperties: false
Mparticle_S2s_Events_Oas_BatchContext:
properties:
data_plan:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_DataPlanContext'
Mparticle_S2s_Events_Oas_BaseEvent:
properties:
data:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_CommonEventData'
event_type:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_EventType'
DataPointMatch:
properties:
type:
$ref: '#/components/schemas/MatchType'
criteria:
$ref: '#/components/schemas/Criteria'
required:
- type
- criteria
title: ''
VersionDocument:
type: object
description: This is the actual data plan, since a data plan can have many versions.
properties:
data_points:
type: array
items:
$ref: '#/components/schemas/DataPoint'
active_transformation_ids:
type: array
items:
type: number
readOnly: true
transformations:
$ref: '#/components/schemas/DataPlanTransformation'
CustomEventCriteria:
properties:
event_name:
type: string
custom_event_type:
type: string
enum:
- unknown
- navigation
- location
- search
- transaction
- user_content
- user_preference
- social
- other
- media
required:
- event_name
- custom_event_type
ErrorList:
type: object
properties:
errors:
type: array
items:
oneOf:
- $ref: '#/components/schemas/Error'
Mparticle_S2s_Events_Oas_SourceInformation:
readOnly: true
properties:
channel:
type: string
enum:
- native
- javascript
- pixel
- desktop
- partner
- server_to_server
partner:
type: string
replay_request_id:
type: string
replay_job_id:
type: string
is_historical:
type: boolean
additionalProperties: false
Mparticle_S2s_Events_Oas_EventType:
type: string
enum:
- session_start
- session_end
- screen_view
- custom_event
- crash_report
- opt_out
- first_run
- pre_attribution
- push_registration
- application_state_transition
- push_message
- network_performance
- breadcrumb
- profile
- push_reaction
- commerce_event
- user_attribute_change
- user_identity_change
- uninstall
Mparticle_S2s_Events_Oas_CommonEventData:
properties:
timestamp_unixtime_ms:
type: integer
event_id:
type: integer
format: int64
readOnly: true
source_message_id:
type: string
session_id:
type: integer
format: int64
session_uuid:
type: string
session_start_unixtime_ms:
type: integer
event_start_unixtime_ms:
type: integer
custom_attributes:
type: object
additionalProperties:
type: string
location:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_GeoLocation'
device_current_state:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_DeviceCurrentState'
is_goal_defined:
type: boolean
lifetime_value_change:
type: boolean
lifetime_value_attribute_name:
type: string
data_connection_type:
type: string
event_num:
type: integer
view_controller:
type: string
is_main_thread:
type: boolean
canonical_name:
type: string
event_system_notification_info:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_EventSystemNotificationInfo'
Mparticle_S2s_Events_Oas_Batch:
additionalProperties: false
type: object
properties:
source_request_id:
type: string
context:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_BatchContext'
events:
type: array
description: Provide a list of event objects - such as CustomEvent, ScreenViewEvent, or CommerceEvent
items:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_BaseEvent'
device_info:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_DeviceInformation'
application_info:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_ApplicationInformation'
user_attributes:
type: object
additionalProperties:
type: object
deleted_user_attributes:
type: array
items:
type: string
user_identities:
type: object
additionalProperties: false
properties:
other:
type: string
customer_id:
type: string
facebook:
type: string
twitter:
type: string
google:
type: string
microsoft:
type: string
yahoo:
type: string
email:
type: string
alias:
type: string
facebook_custom_audience_id:
type: string
other_id_2:
type: string
other_id_3:
type: string
other_id_4:
type: string
other_id_5:
type: string
other_id_6:
type: string
other_id_7:
type: string
other_id_8:
type: string
other_id_9:
type: string
other_id_10:
type: string
mobile_number:
type: string
phone_number_2:
type: string
phone_number_3:
type: string
environment:
type: string
default: production
enum:
- unknown
- development
- production
api_key:
type: string
api_keys:
type: array
items:
type: string
ip:
type: string
integration_attributes:
type: object
additionalProperties:
type: object
additionalProperties:
type: string
partner_identity:
type: string
source_info:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_SourceInformation'
mp_deviceid:
type: string
attribution_info:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_AttributionInfo'
timestamp_unixtime_ms:
type: integer
format: int64
batch_id:
type: integer
format: int64
mpid:
type: integer
format: int64
sdk_version:
type: string
consent_state:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_ConsentState'
job_id:
type: string
required:
- environment
DataPlanTransformation:
title: DataPlanTransformation
type: object
properties:
transformation_id:
type: number
transformation_name:
type: string
error_pointer:
type: string
validation_error_types:
type: array
items:
type: string
enum:
- unknown
- unplanned
- missing_required
- invalid_value
schema_keywords:
type: array
items:
$ref: '#/components/schemas/SchemaKeyword'
json_patch:
type: array
items:
$ref: '#/components/schemas/DataPlanPatch'
description:
type: string
DataPointValidator:
properties:
type:
type: string
default: json_schema
enum:
- json_schema
definition:
type: object
description: This should be a valid JSON schema
required:
- type
- definition
Error:
type: object
properties:
message:
type: string
Mparticle_S2s_Events_Oas_DeviceInformation:
properties:
brand:
type: string
product:
type: string
device:
type: string
android_uuid:
type: string
device_manufacturer:
type: string
platform:
type: string
enum:
- iOS
- Android
- web
- desktop
- tvOS
- roku
- out_of_band
- smart_tv
- xbox
os_version:
type: string
device_model:
type: string
screen_height:
type: integer
screen_width:
type: integer
screen_dpi:
type: integer
device_country:
type: string
locale_language:
type: string
locale_country:
type: string
network_country:
type: string
network_carrier:
type: string
network_code:
type: string
network_mobile_country_code:
type: string
timezone_offset:
type: integer
build_identifier:
type: string
http_header_user_agent:
type: string
ios_advertising_id:
type: string
att_authorization_status:
type: string
enum:
- authorized
- denied
- not_determined
- restricted
att_timestamp_unixtime_ms:
type: number
push_token:
type: string
cpu_architecture:
type: string
is_tablet:
type: boolean
push_notification_sound_enabled:
type: boolean
push_notification_vibrate_enabled:
type: boolean
radio_access_technology:
type: string
supports_telephony:
type: boolean
has_nfc:
type: boolean
bluetooth_enabled:
type: boolean
bluetooth_version:
type: string
ios_idfv:
type: string
android_advertising_id:
type: string
build_version_release:
type: string
limit_ad_tracking:
type: boolean
amp_id:
type: string
is_dst:
type: boolean
roku_advertising_id:
type: string
roku_publisher_id:
type: string
microsoft_advertising_id:
type: string
microsoft_publisher_id:
type: string
fire_advertising_id:
type: string
additionalProperties: false
MatchType:
type: string
enum:
- unknown
- screen_view
- custom_event
- user_attributes
- user_identities
- product_action
- promotion_action
- product_impression
Mparticle_S2s_Events_Oas_ConsentState:
properties:
gdpr:
$ref: '#/components/schemas/Mparticle_S2s_Events_Oas_GDPRConsentState'
required:
- gdpr
additionalProperties: false
ActivatedEnvironment:
type: string
enum:
- none
- development
- production
description: Data plan can be active in development, production & development (production), or neither. 'none' indicates it's inactive.
Mparticle_S2s_Events_Oas_EventSystemNotificationInfo:
readOnly: true
properties:
type:
type: string
enum:
- gdpr_change
required:
- type
Criteria:
anyOf:
- $ref: '#/components/schemas/ScreenViewEventCriteria'
- $ref: '#/components/schemas/CustomEventCriteria'
- $ref: '#/components/schemas/UserAttributeCriteria'
- $ref: '#/components/schemas/CommerceActionEventCriteria'
SchemaErrorList:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/SchemaError'
SchemaKeyword:
type: string
title: SchemaKeyword
enum:
- none
- additionalItems
- additionalProperties
- allOf
- anyOf
- const
- contains
- contentEncoding
- contentMediaType
- default
- definitions
- dependencies
- dependentRequired
- dependentSchemas
- else
- enum
- exclusiveMaximum
- exclusiveMinimum
- format
- id
- if
- items
- maxContains
- maximum
- maximum
- maxLength
- maxProperties
- minContains
- minimum
- minItems
- minLength
- minProperties
- multipleOf
- not
- oneOf
- pattern
- patternProperties
- properties
- propertyNames
- readOnly
- required
- then
- type
- unevaluatedItems
- unevaluatedProperties
- uniqueItems
- writeOnly
- $anchor
- $defs
- $id
- $recursiveAnchor
- $recursiveRef
- $ref
- $schema
- $vocabulary
- timeLimit
- $comment
- description
- examples
- title
Mparticle_S2s_Events_Oas_AttributionInfo:
properties:
service_provider:
type: string
publisher:
type: string
campaign:
type: string
required:
- service_provider
- publisher
- campaign
additionalProperties: false
DataPlan:
x-examples: {}
type: object
properties:
data_plan_id:
type: string
data_plan_name:
type: string
data_plan_description:
type: string
data_plan_versions:
$ref: '#/components/schemas/DataPlanVersionList'
created_on:
type: string
format: date-time
created_by:
type: string
last_modified_on:
type: string
format: date-time
last_modified_by:
type: string
DataPlanPatch:
title: DataPlanPatch
type: object
properties:
op:
type: string
enum:
- unknown
- add
- remove
- replace
- copy
- move
- test
from:
type: string
path:
type: string
value:
type: string
ScreenViewEventCriteria:
properties:
screen_name:
type: string
required:
- screen_name
CommerceActionEventCriteria:
title: CommerceActionEventCriteria
type: object
properties:
action:
oneOf:
- $ref: '#/components/schemas/ProductAction'
- $ref: '#/components/schemas/PromotionAction'
description: Data point match criteria object for commerce action events
PromotionAction:
type: string
title: PromotionAction
enum:
- view
- click
UserAttributeCriteria:
type: object
DataPlanVersionList:
type: array
items:
$ref: '#/components/schemas/DataPlanVersion'
parameters:
plan_id:
name: plan_id
in: path
description: Slug ID of the data plan
required: true
schema:
type: string
responses:
DataPlanVersionResponse:
description: Data plan version
content:
application/json:
schema:
$ref: '#/components/schemas/DataPlanVersion'
Unauthorized:
description: Unauthorized
DataPlanResponse:
description: Data plan created
content:
application/json:
schema:
$ref: '#/components/schemas/DataPlan'
Forbidden:
description: Forbidden
DataPlanNotFound:
description: Not Found
content:
application/json:
schema:
description: ''
type: object
properties:
errors:
type: array
uniqueItems: true
minItems: 1
items:
required:
- message
properties:
message:
type: string
minLength: 1
required:
- errors
x-examples:
example-1:
errors:
- message: The specified plan ID plan_1 in workspace 1234 was not found.
examples:
example-1:
value:
errors:
- message: The specified plan ID plan_1 in workspace 1234 was not found.
headers: {}
ValidateDataPlanResponse:
description: Example response
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
properties:
data:
allOf:
- type: object
properties:
match:
$ref: '#/components/schemas/DataPointMatch'
validation_errors:
type: array
items:
type: object
properties:
validation_error_type:
type: string
enum:
- unknown
- unplanned
- missing_required
- invalid_value
key:
type: string
example: event name or attribute name
error_pointer:
type: string
example: '#/data/custom_attributes/foo-attr-1'
expected:
type: string
example: null for unplanned entities, the entity name for missing required entities, a data type (e.g. "number") for invalid data types, etc
actual:
type: string
example: the entity name for unplanned entities, null for missing required entities, a data type (e.g. "string") for invalid data types, etc
action_expected:
type: string
enum:
- unknown
- allow
- drop_event
- drop_attribute
- drop_batch
schema_keyword:
$ref: '#/components/schemas/SchemaKeyword'
validated_event_id:
type: number
validated_source_message_id:
type: string
executed_transformations:
type: object
properties:
transformation_id:
type: number
transformation_status:
type: string
enum:
- success
- failure
- unchanged
- quarantined
transformation_error_type:
type: string
enum:
- valid
- invalid
- unrecognized_data_point
- events_schema_violated
transformation_error_message:
type: string
transformation_error_pointer:
type: string
- $ref: '#/components/schemas/Mparticle_S2s_Events_Oas_CommonEventData'
batch:
type: object
TooManyRequests:
description: Too Many Requests
headers:
Retry-After:
description: Seconds to wait until the next request attempt
schema:
type: integer
DataPlanListResponse:
description: Data plan list
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DataPlan'
examples:
example-1:
value:
- data_plan_id: string
data_plan_name: string
created_on: '2019-08-24T14:15:22Z'
created_by: string
last_modified_on: '2019-08-24T14:15:22Z'
last_modified_by: string
description: string
data_plan_versions:
- version: 0
version_description: string
created_on: '2019-08-24T14:15:22Z'
created_by: string
last_modified_on: '2019-08-24T14:15:22Z'
last_modified_by: string
version_document:
data_points:
- description: string
match:
type: unknown
criteria:
screen_name: string
validator:
type: json_schema
definition: {}
active_transformation_ids:
- 0
active_transformation_ids:
- 0
activated_environment: development
BadSchema:
description: Bad Schema
content:
application/json:
schema:
# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mparticle/refs/heads/main/openapi/mparticle-data-plan-api-openapi.yml