Reference

Get plans and prices

GET /v1/plans. Plans, credit packs, credit rules, licence terms, the guarantee and the free trial, in GBP excluding VAT.

Generated from the contractsView as Markdown

GET /v1/plans

Plans, credit packs, credit rules, licence terms, the guarantee and the free trial, in GBP excluding VAT. The same content as https://mydatahub.emailmovers.com/pricing.json. One credit buys one complete UK record at the same price in the app, API and MCP server.

Property	Value
Endpoint	`GET https://mydatahub.emailmovers.com/v1/plans`
Operation id	`getPlans`
Cost	Free (0 credits)
Access	No account, key or token needed.
MCP tool	`get_plans`
Tag	Catalogue

Request

Parameters

Name	In	Type	Required	Description
`MyDataHub-Version`	header	string	no	The dated API version, pinned per key when left out. Non-breaking changes ship as new dates; the path major changes only for breaking changes, with a 12 month deprecation window.

Example request

curl "https://mydatahub.emailmovers.com/v1/plans"

Responses

200: Plans and prices.

Headers: RateLimit, RateLimit-Policy.

Member	Type	Always present	Description
`version`	string	yes
`valid_from`	string (date)	yes
`currency`	`GBP`	yes
`vat_treatment`	string	yes
`credit_definition`	string	yes
`price_scale`	`PriceScale`	yes	The per-contact scale: 1 credit buys 1 record at the rate of the band the purchase falls in. A quote's purchase options compare it with the credit pack and lead with the cheapest.
`price_scale.id`	`per_contact_scale`	yes
`price_scale.name`	string	yes
`price_scale.status`	enum: `confirmed`, `proposed`, `to_confirm`	yes	confirmed is in force; proposed awaits a decision; to_confirm is a figure still being checked.
`price_scale.available_to`	enum: `everyone`, `new_customers`, `existing_customers`	yes	everyone; new_customers only (the subscription); existing_customers only, who keep their prices (pay as you go and the 12-month plan).
`price_scale.minimum_order_records`	integer (0 or more)	yes
`price_scale.rule`	string	yes	How a purchase is priced, in words.
`price_scale.bands`	array of `PriceBand`	yes
`plans`	array of `Plan`	yes
`plans[].id`	string	yes	Such as free, pay_as_you_go or plan_12_month.
`plans[].name`	string	yes
`plans[].kind`	enum: `free`, `subscription`, `pack`	yes
`plans[].status`	enum: `confirmed`, `proposed`, `to_confirm`	yes	confirmed is in force; proposed awaits a decision; to_confirm is a figure still being checked.
`plans[].available_to`	enum: `everyone`, `new_customers`, `existing_customers`	yes	everyone; new_customers only (the subscription); existing_customers only, who keep their prices (pay as you go and the 12-month plan).
`plans[].price_gbp_ex_vat`	number (0 or more)	yes	Pounds sterling excluding VAT, to two decimal places.
`plans[].billing_period`	enum: `once`, `month`, `year`	yes
`plans[].contract_months`	integer (0 or more) or null	no	The contract's length in months, such as 12; absent when there is none.
`plans[].annual_price_gbp_ex_vat`	number (0 or more) or null	no
`plans[].credits`	integer (0 or more)	yes	Credits per billing period, or once.
`plans[].per_record_gbp`	number (0 or more) or null	yes	Price per record at full use of the allowance; null for the free plan.
`plans[].rollover_cap_credits`	integer (0 or more) or null	no	Subscription credits roll over while subscribed, up to this many; 0 when each period's credits are used or lost.
`plans[].credits_expire`	boolean	yes
`plans[].for_whom`	string	yes
`plans[].notes`	string	no
`credit_packs`	array of `CreditPack`	yes
`credit_packs[].id`	string	yes	Such as free, pay_as_you_go or plan_12_month.
`credit_packs[].name`	string	yes
`credit_packs[].kind`	`pack`	yes
`credit_packs[].status`	enum: `confirmed`, `proposed`, `to_confirm`	yes	confirmed is in force; proposed awaits a decision; to_confirm is a figure still being checked.
`credit_packs[].available_to`	enum: `everyone`, `new_customers`, `existing_customers`	yes	everyone; new_customers only (the subscription); existing_customers only, who keep their prices (pay as you go and the 12-month plan).
`credit_packs[].price_gbp_ex_vat`	number (0 or more)	yes	Pounds sterling excluding VAT, to two decimal places.
`credit_packs[].billing_period`	`once`	yes
`credit_packs[].contract_months`	integer (0 or more) or null	no	The contract's length in months, such as 12; absent when there is none.
`credit_packs[].annual_price_gbp_ex_vat`	number (0 or more) or null	no
`credit_packs[].credits`	integer (0 or more)	yes	Credits per billing period, or once.
`credit_packs[].per_record_gbp`	number (0 or more) or null	yes	Price per record at full use of the allowance; null for the free plan.
`credit_packs[].rollover_cap_credits`	integer (0 or more) or null	no	Subscription credits roll over while subscribed, up to this many; 0 when each period's credits are used or lost.
`credit_packs[].credits_expire`	boolean	yes
`credit_packs[].for_whom`	string	yes
`credit_packs[].notes`	string	no
`credit_rules`	array of `CreditRule`	yes
`credit_rules[].action`	string	yes
`credit_rules[].label`	string	yes
`credit_rules[].credits`	number (0 or more)	yes	Credits, to one decimal place: whole at 1 credit a record, fractional only where a rule is (0.1 company-only, 1.8 outright, both proposed).
`credit_rules[].unit`	enum: `call`, `record`, `match`	yes
`credit_rules[].status`	enum: `confirmed`, `proposed`, `to_confirm`	yes	confirmed is in force; proposed awaits a decision; to_confirm is a figure still being checked.
`credit_rules[].note`	string	no
`licence`	array of `LicenceTerms`	yes
`licence[].licence_type`	enum: `multi_use_12m`, `outright`	yes	multi_use_12m (12 month multi-use, every plan) or outright (1.8 credits a record, proposed).
`licence[].status`	enum: `confirmed`, `proposed`	yes
`licence[].credits_per_record`	number	yes
`licence[].permitted_channels`	array of enum: `email`, `telephone`, `post`	yes
`licence[].reuse_months`	integer or null	yes	12 for multi_use_12m; null for outright.
`licence[].resale_prohibited`	boolean	yes
`licence[].warranty_url`	string (uri)	yes
`licence[].terms_version`	string	yes
`guarantee`	object	yes
`guarantee.current`	`Warranty`	yes	The bounce warranty that covers delivered records, with the threshold it was issued under.
`guarantee.proposed`	`Warranty` or null	yes
`guarantee.refunds`	array of string	yes
`trial`	object	yes
`trial.credits`	integer (0 or more)	yes
`trial.card_required`	boolean	yes
`trial.expires`	boolean	yes
`promises`	array of `PricingPromise`	yes
`promises[].key`	string	yes
`promises[].statement`	string	yes
`promises[].in_practice`	string	yes
`meters`	array of `Meter`	yes	What agents and code are metered on, in credits, the same on every surface.
`meters[].action`	string	yes	What is metered, such as record or enrich_contact.
`meters[].unit`	enum: `record`, `match`, `call`	yes
`meters[].credits`	number (0 or more)	yes	Credits per unit.
`meters[].status`	enum: `confirmed`, `proposed`, `to_confirm`	yes	confirmed is in force; proposed awaits a decision; to_confirm is a figure still being checked.
`action_path`	array of `ActionPathStep`	yes	How to buy: quote_order for a machine quote, create_order with a confirmation, and the top-up page when the balance is short.
`action_path[].step`	integer (1 or more)	yes

Showing the first 80 of 83 members. The OpenAPI document and the MCP tool list hold the full schema.

Example response

{
  "version": "2026-10",
  "valid_from": "2026-10-13",
  "currency": "GBP",
  "vat_treatment": "Prices exclude VAT at 20 percent.",
  "credit_definition": "1 credit buys 1 complete UK record, delivered once, at the per-contact scale's rate, the same in the app, API and MCP server.",
  "price_scale": {
    "id": "per_contact_scale",
    "name": "Per-contact scale",
    "status": "confirmed",
    "available_to": "everyone",
    "minimum_order_records": 0,
    "rule": "The credits bought, after any balance, pick one band, and every credit in the purchase is at its rate. A quote compares the scale with the credit pack and leads with the cheaper.",
    "bands": [
      {
        "from_records": 1,
        "to_records": 2999,
        "gbp_per_record": 0.25
      },
      {
        "from_records": 3000,
        "to_records": 9999,
        "gbp_per_record": 0.25
      },
      {
        "from_records": 10000,
        "to_records": 24999,
        "gbp_per_record": 0.22
      },
      {
        "from_records": 25000,
        "to_records": 49999,
        "gbp_per_record": 0.195
      },
      {
        "from_records": 50000,
        "to_records": null,
        "gbp_per_record": 0.17
      }
    ]
  },
  "plans": [
    {
      "id": "free",
      "name": "Free",
      "kind": "free",
      "status": "confirmed",
      "available_to": "everyone",
      "price_gbp_ex_vat": 0,
      "billing_period": "once",
      "credits": 100,
      "per_record_gbp": null,
      "credits_expire": false,
      "for_whom": "Triallists, human or agent",
      "notes": "No card"
    },
    {
      "id": "pay_as_you_go",
      "name": "Pay as you go",
      "kind": "subscription",
      "status": "confirmed",
      "available_to": "existing_customers",
      "price_gbp_ex_vat": 299,
      "billing_period": "month",
      "credits": 1000,
      "per_record_gbp": 0.299,
      "rollover_cap_credits": 12000,
      "credits_expire": false,
      "for_whom": "Existing customers, who keep this price",
      "notes": "Cancel any time. Not sold to new customers since 13 October 2026."
    },
    {
      "id": "plan_12_month",
      "name": "12-month plan",
      "kind": "subscription",
      "status": "confirmed",
      "available_to": "existing_customers",
      "price_gbp_ex_vat": 249,
      "billing_period": "month",
      "annual_price_gbp_ex_vat": 2988,
      "credits": 1000,
      "per_record_gbp": 0.249,
      "rollover_cap_credits": 12000,
      "credits_expire": false,
      "for_whom": "Existing customers, who keep this price",
      "notes": "Not sold to new customers since 13 October 2026."
    },
    {
      "id": "subscription_2000",
      "name": "Subscription",
      "kind": "subscription",
      "status": "confirmed",
      "available_to": "new_customers",
      "price_gbp_ex_vat": 500,
      "billing_period": "month",
      "contract_months": 12,
      "annual_price_gbp_ex_vat": 6000,
      "credits": 2000,
      "per_record_gbp": 0.25,
      "rollover_cap_credits": 0,
      "credits_expire": true,
      "for_whom": "Teams that buy every month",
      "notes": "A 12-month contract. Each month's 2,000 records are used or lost; records beyond them cost the quote's cheapest purchase."
    }
  ],
  "credit_packs": [
    {
      "id": "credit_pack_40000",
      "name": "Credit pack 40,000",
      "kind": "pack",
      "status": "confirmed",
      "available_to": "everyone",
      "price_gbp_ex_vat": 1249,
      "billing_period": "once",
      "credits": 40000,
      "per_record_gbp": 0.031,
      "credits_expire": false,
      "for_whom": "Anyone buying about 5,000 records or more"
    }
  ],
  "credit_rules": [
    {
      "action": "count",
      "label": "Count, breakdown, preview, machine quote, catalogue, title expansion",
      "credits": 0,
      "unit": "call",
      "status": "confirmed"
    },
    {
      "action": "record",
      "label": "Full UK contact record delivered, any channel or field set",
      "credits": 1,
      "unit": "record",
      "status": "confirmed"
    },
    {
      "action": "company_only_record",
      "label": "Company-only record (no named contact)",
      "credits": 0.1,
      "unit": "record",
      "status": "proposed"
    },
    {
      "action": "enrich_contact",
      "label": "Contact enrichment, match found",
      "credits": 1,
      "unit": "match",
      "status": "confirmed",
      "note": "0 if already licensed"
    },
    {
      "action": "lookup_company",
      "label": "Company lookup, no contact details",
      "credits": 0,
      "unit": "call",
      "status": "to_confirm"
    },
    {
      "action": "outright",
      "label": "Outright ownership",
      "credits": 1.8,
      "unit": "record",
      "status": "proposed"
    }
  ],
  "licence": [
    {
      "licence_type": "multi_use_12m",
      "status": "confirmed",
      "credits_per_record": 1,
      "permitted_channels": ["email", "telephone", "post"],
      "reuse_months": 12,
      "resale_prohibited": true,
      "warranty_url": "https://emailmovers.com/trust/warranty",
      "terms_version": "2026-09"
    }
  ],
  "guarantee": {
    "current": {
      "policy": "replace_over_threshold_hard_bounce",
      "threshold_percent": 10,
      "url": "https://emailmovers.com/trust/warranty"
    },
    "proposed": {
      "policy": "replace_any_hard_bounce_30d",
      "url": "https://emailmovers.com/trust/warranty"
    },
    "refunds": [
      "Credits and credit packs are not refundable once bought, except where the law requires.",
      "Existing customers keep what their signed agreement says until it renews."
    ]
  },
  "trial": {
    "credits": 100,
    "card_required": false,
    "expires": false
  },
  "meters": [
    {
      "action": "record",
      "unit": "record",
      "credits": 1,
      "status": "confirmed"
    },
    {
      "action": "enrich_contact",
      "unit": "match",
      "credits": 1,
      "status": "confirmed"
    },
    {
      "action": "company_only_record",
      "unit": "record",
      "credits": 0.1,
      "status": "proposed"
    },
    {
      "action": "outright",
      "unit": "record",
      "credits": 1.8,
      "status": "proposed"
    },
    {
      "action": "count",
      "unit": "call",
      "credits": 0,
      "status": "confirmed"
    }
  ],
  "action_path": [
    {
      "step": 1,
      "action": "quote_order",
      "rest": "POST /v1/quotes",
      "description": "Get a signed machine quote for a count, valid 24 hours. Free."
    },
    {
      "step": 2,
      "action": "create_order",
      "rest": "POST /v1/orders",
      "description": "Spend credits against the quote_id with a person's confirmation or an agent key within its limits."
    },
    {
      "step": 3,
      "action": "https://mydatahub.emailmovers.com/billing/top-up",
      "rest": null,
      "description": "When the balance is short, buy one of the quote's purchase options (the cheapest comes first) through Stripe Checkout, then retry step 2."
    }
  ],
  "promises": [
    {
      "key": "looking_is_free",
      "statement": "Looking is free forever",
      "in_practice": "Filters, counts, breakdowns, masked previews, machine quotes, plans and trust documents need no account or card."
    },
    {
      "key": "never_pay_twice",
      "statement": "Never pay twice",
      "in_practice": "Re-downloads under licence, duplicates, suppressed records, records you already hold and failed lookups cost 0."
    }
  ]
}

Errors

Every error is a problem object with a code and a next_step. Every response carries the RateLimit and RateLimit-Policy headers; see Rate limits.

Status	Problem codes	When
400	`invalid-request`, `idempotency-key-required`, `unsupported-version`	The request could not be read, or an Idempotency-Key is missing.
429	`rate-limited`	Too many requests. Wait for Retry-After.
Any other failure	`internal-error`, `service-unavailable`, `tps-screen-expired`	Something failed on our side (500 internal-error) or the service is briefly unavailable (503 service-unavailable, with Retry-After). Nothing was charged; retry with the same Idempotency-Key. A count, sample, quote or order with telephone in play is also refused with 503 tps-screen-expired, with no Retry-After, while the dataset version's TPS and CTPS screen is more than 28 days old.