Bud Financial Limited

Bud Financial Limited Drive Segments API

Create and manage customer segments — Drive's V1 model (fixed customer lists, criteria copied from an existing segment) and V2 model (a recursive criteria tree of flags, segment dependencies, and logical combinations). `Get Criteria Options` is the single source of truth for what's available to build a criteria from.

Documentation GitHub OpenAPI

Operations 23

POST /drive-api/v1/segments/from-existing/criteria Create Segment From Existing (Criteria) #

POST /drive-api/v1/segments/from-existing/fixed-customers Create Segment From Existing (Fixed Customers) #

POST /drive-api/v1/segments/upload Upload Segment #

GET /drive-api/v1/segments/{segment_id} Retrieve Segment #

PATCH /drive-api/v1/segments/{segment_id} Patch Segment #

DELETE /drive-api/v1/segments/{segment_id} Delete Segment #

POST /drive-api/v1/segments/{segment_id}/query Query Segment Customers #

GET /drive-api/v1/segments/{segment_id}/similarity/{other_segment_id} Compare Segments (Similarity) #

GET /drive-api/v1/segments/{segment_id}/statistics/overview Get Segment Statistics Overview #

GET /drive-api/v1/tags Retrieve Segment Tags #

POST /drive-api/v2/criteria/drafts Create Draft Criteria #

GET /drive-api/v2/criteria/drafts/{criteria_id} Get Draft Criteria #

PUT /drive-api/v2/criteria/drafts/{criteria_id} Update Draft Criteria #

POST /drive-api/v2/criteria/drafts/{criteria_id}/run Run Draft Criteria #

GET /drive-api/v2/criteria/options Get Criteria Options #

POST /drive-api/v2/criteria/run Run Ad-hoc Criteria #

POST /drive-api/v2/criteria/suggestions/segment-name Suggest Segment Name #

GET /drive-api/v2/segments Get Segments #

POST /drive-api/v2/segments Create Segment #

GET /drive-api/v2/segments/{segment_id}/criteria Get Segment Criteria #

GET /drive-api/v2/segments/{segment_id}/criteria/active-options Get Segment Criteria Active Options #

POST /drive-api/v2/segments/{segment_id}/criteria/run Run Segment Criteria #

PUT /drive-api/v2/segments/{segment_id}/criteria/{criteria_id} Save Segment Criteria #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/openapi/thisisbud-drive-segments-api-api-openapi.yml

Schemas & Data

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-transaction-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-auth-gateway-urlrequestv2-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-patch-spending-budget-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-get-products-response-v2-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-get-balances-v3-response-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-get-balances-response-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-schemas-transaction-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/json-schema/thisisbud-usauth-gateway-urlrequestv2-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/thisisbud:thisisbud-drive-segments-api-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Drive Segments API
  version: 1.0.0
  contact:
    name: API Support
    url: http://www.thisisbud.com/support
    email: contact@thisisbud.com
  x-logo:
    url: data:image/png;base64,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
  description: 'Drive lets you understand your customers using the flags it compiles from data across every

    source you bring in — not just transactions — build segments from those flags, and run

    personalized campaigns against them. Drive works in a loop: **understand** your customers (via

    the flags that make up Drive''s criteria), **segment** them (Drive Segments API), and **engage**

    them (Drive Campaigns API). Measuring a campaign''s performance feeds back into segmentation, so

    the next audience is sharper than the last.


    Campaigns don''t have to be built step by step, either: describe the outcome you want in plain

    language and Drive''s campaign agent finds the matching audience, writes the copy, generates the

    artwork, and estimates the opportunity for you.


    Segments V2 endpoints return non-standard vendor content types

    (`application/vnd.bud.drive.notification+json`, `.criteria+json`, `.visualisation+json`,

    `.criteria-options+json`) rather than plain `application/json` — check the `Content-Type` of

    these responses rather than assuming JSON.'
servers:
- url: https://api-sandbox.thisisbud.com
  description: Bud sandbox
tags:


# --- truncated at 32 KB (66 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/thisisbud/refs/heads/main/openapi/thisisbud-drive-segments-api-api-openapi.yml