Reference

List credit purchases

GET /v1/account/purchases. Credits bought by card, newest first, each with its price excluding VAT, the VAT, the total and, once paid, its payment receipt.

Generated from the contractsView as Markdown

GET /v1/account/purchases

Credits bought by card, newest first, each with its price excluding VAT, the VAT, the total and, once paid, its payment receipt. payments says whether card payments are switched on here and whether they are Stripe test mode.

Property	Value
Endpoint	`GET https://mydatahub.emailmovers.com/v1/account/purchases`
Operation id	`listCreditPurchases`
Cost	Free (0 credits)
Access	An API key or an OAuth 2.1 token with the scope `account:read`.
Tag	Account

Request

Parameters

Name	In	Type	Required	Description
`limit`	query	integer (1 to 100)	no	Items per page, 1 to 100. Default 25.
`cursor`	query	string	no	An opaque cursor from next_cursor. Pass it back unchanged.
`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/account/purchases" \
  -H "Authorization: Bearer $MYDATAHUB_API_KEY"

Responses

200: A page of credit purchases.

Headers: RateLimit, RateLimit-Policy.

Member	Type	Always present	Description
`data`	array of `CreditPurchase`	yes
`data[].id`	string	yes	Format: a credit purchase id: pur_ followed by a 26 character ULID in upper case Crockford base32, such as pur_01JB4R7K2V7XN3M9R6T1Y5W8ZA.
`data[].status`	enum: `pending`, `paid`, `expired`	yes	pending until Stripe says the payment is paid; paid once the credits are in the balance; expired when the checkout closed unpaid (nothing was taken).
`data[].label`	string	yes	What is bought, in words, numbers first.
`data[].lines`	array of `CreditPurchaseLine`	yes
`data[].credits`	integer (0 or more)	yes	Credits the purchase adds when paid.
`data[].gbp_ex_vat`	number (0 or more)	yes	Pounds sterling excluding VAT, to two decimal places.
`data[].vat_rate_percent`	number (0 to 100)	yes
`data[].vat_gbp`	number (0 or more)	yes	Pounds sterling, to two decimal places.
`data[].total_gbp`	number (0 or more)	yes	What the card is charged, VAT included.
`data[].currency`	`GBP`	yes
`data[].gbp_per_credit`	number (0 or more)	yes	What one credit of this purchase cost, excluding VAT, to six decimal places. Orders value the credits they spend at it.
`data[].credits_added`	integer (0 or more)	yes	0 until the payment is paid.
`data[].checkout_url`	string (uri) or null	yes	Stripe Checkout, while the purchase is pending; null once paid or expired.
`data[].test_mode`	boolean	yes	Made with a Stripe test key: test cards only, and no money moves.
`data[].created_at`	string (date-time)	yes
`data[].expires_at`	string (date-time) or null	yes	When the checkout closes if it is not paid.
`data[].paid_at`	string (date-time) or null	yes
`data[].attention`	`PurchaseAttention` or null	yes
`data[].receipt`	`PaymentReceipt` or null	yes	Once paid. The buyer's name, billing address and VAT number are shown only to a signed-in person with admin; anyone else sees them as null.
`has_more`	boolean	yes	Whether another page follows.
`next_cursor`	string or null	yes	Pass as cursor to fetch the next page; null on the last page.
`payments`	object	yes	How credits are bought here.
`payments.available`	boolean	yes	Whether card payments are switched on for this server.
`payments.test_mode`	boolean	yes	Stripe test mode: test cards only.
`payments.vat_rate_percent`	number (0 to 100)	yes

Example response

{
  "data": [
    {
      "id": "pur_01JB4R7K2V7XN3M9R6T1Y5W8ZA",
      "label": "1 credit pack of 40,000",
      "lines": [
        {
          "id": "credit_pack_40000",
          "quantity": 1,
          "credits": 40000,
          "gbp_ex_vat": 1249
        }
      ],
      "credits": 40000,
      "gbp_ex_vat": 1249,
      "vat_rate_percent": 20,
      "vat_gbp": 249.8,
      "total_gbp": 1498.8,
      "currency": "GBP",
      "gbp_per_credit": 0.031225,
      "test_mode": true,
      "created_at": "2026-10-16T10:00:00Z",
      "expires_at": "2026-10-17T10:00:00Z",
      "attention": null,
      "status": "paid",
      "credits_added": 40000,
      "checkout_url": null,
      "paid_at": "2026-10-16T10:03:12Z",
      "receipt": {
        "number": "MDH-000042",
        "issued_at": "2026-10-16T10:03:12Z",
        "supplier": {
          "name": "Example Supplier Limited",
          "company_number": "00000000",
          "registered_office": "1 Example Street, Exampletown, EX1 1EX, England",
          "vat_number": "GB000000000"
        },
        "customer": {
          "organisation_id": "org_01JA0Q2V7XN3M9R6T1Y5W8ZAK8",
          "organisation_name": "Example Agency Ltd",
          "business_name": "Example Agency Ltd",
          "name": "Example Agency Ltd",
          "address": {
            "line1": "2 Sample Road",
            "line2": null,
            "city": "Exampletown",
            "postal_code": "EX2 2EX",
            "state": null,
            "country": "GB"
          },
          "vat_number": "GB999999999"
        },
        "description": "1 credit pack of 40,000",
        "credits": 40000,
        "gbp_per_credit": 0.031225,
        "gbp_ex_vat": 1249,
        "vat_rate_percent": 20,
        "vat_gbp": 249.8,
        "total_gbp": 1498.8,
        "paid_by": "card",
        "payment_reference": "pi_test_EXAMPLE",
        "refunds": "Credits and credit packs are not refundable once bought, except where the law requires.",
        "test_mode": true
      }
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "payments": {
    "available": true,
    "test_mode": true,
    "vat_rate_percent": 20
  }
}

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.
401	`authentication-required`, `account-required`	Sign in (OAuth) or send an API key (authentication-required), or create a free account for what the anonymous tier does not cover (account-required).
403	`insufficient-scope`, `confirmation-required`, `business-details-required`, `licence-acceptance-required`, `dpa-acceptance-required`, `agent-budget-exceeded`	The token lacks a scope (insufficient-scope, with required_scope and a WWW-Authenticate step-up challenge); no person confirmed the spend and no agent key covers it (confirmation-required, with an approval_url); an agent key's per-order cap or monthly budget does not cover it (agent-budget-exceeded); an account made by self-serve sign-up has not yet confirmed its business name and that it is a UK business, which its first order needs (business-details-required); the order needs the Data Licence and Sharing Agreement accepted at the version in force (licence-acceptance-required); or a suppression upload comes before the organisation has accepted the Article 28 data processing agreement in force (dpa-acceptance-required). Nothing is charged.
422	`validation-failed`, `quote-required`, `dataset-unavailable`	The request is not valid. errors lists every problem with a JSON pointer and did_you_mean.
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.